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杨 春 华 MRE 译 
我 很 布 望 10 年 前 束 拥 有 这 本 书 。 可 能 有 人 认为 我 不 需要 任何 Java 


Ara 


| 
方面 的 书籍 ， 但 是 我 需要 这 本 书 


Java 之 父 James Gosling 


HA 


Java 从 诞生 到 日 趋 完 善 ， 经 过 了 不 断 的 发 展 壮大 ， 目 前 全 世界 拥有 了 
成 千 上 万 的 Java 开 发 人 员 。 如 何 编写 出 更 清晰 、 更 正确 、 更 健壮 且 更 
易于 重用 的 代码 ， 是 大 家 所 追求 的 目标 之 一 。 作 为 经 典 Jolt 获 奖 作 品 的 
新 版 书 ， 它 已 经 进行 了 彻底 的 更 新 ， 泣 盖 了 自 第 1 版 之 后 所 引入 的 Java 
SE 5 和 Java SE 6 的 新 特性 。 作 者 探索 了 新 的 设计 模式 和 语言 习惯 用 
法 ， 介 绍 了 如 何 充 分 利用 从 泛 型 到 枚 举 、 从 注解 到 自动 装 箱 的 各 种 个 
性 。 本 书 的 作者 Joshua Bloch 兽 经 是 Sun 公 司 的 杰出 工程 师 ， 带 领 团 队 
设计 和 实现 过 无 数 的 Java 平 台 特性 ， 包 括 JDK 5.0 语 言 增强 版 和 获奖 的 


Java Collections Framework。 他 也 是 Jolt 奖 的 获得 者 ， 现 在 担任 Google 
公司 的 下 局 Java 架 构 师 。 他 为 我 们 市 来 了 共 78 条 程序 员 必 备 的 经 验 法 
MU: 针对 你 每 天 都 会 遇 到 的 编程 问题 提出 了 最 有 效 、 最 实用 的 解决 方 


AN 


书 中 的 每 一 章 都 包含 几 个 “条 目 ”， 以 简 污 的 形式 呈现 ， 目 成 独立 的 短 
X, 它们 提出 了 具体 的 建议 、 对 于 Java 平 台 精 妙 之 处 的 独到 见解 ， 并 
提供 优秀 的 代码 范例 。 每 个 条 目的 综合 描述 和 解释 都 阐明 了 应 该 怎么 
做 、 不 应 该 怎么 做 ， 以 及 为 什么 。 通过 贯穿 全 书 透 彻 的 技术 剖析 与 完 
整 的 示例 代码 ， 仔 细 研 读 并 加 以 理解 与 实践 ， 必 定 会 从 中 受益 菲 浅 。 
书 中 介绍 的 示例 代码 清晰 易 懂 ， 也 可 以 作为 日 第 工作 的 参考 指南 。 


适合 人 群 


本 书 不 是 针对 初学 者 的 ， 读 者 至 少 需 要 熟悉 Java 程 序 设计 语言 。 如 果 
你 连 equlas() `~ toString() `~ hashcode() 都 还 不 了 解 的 话 ， 建议 先 去 
看 些 优秀 的 Java 入 [|] 书籍 之 后 再 来 阅读 本 书 。 如 果 你 现在 已 经 在 Java 
开发 方面 有 了 一 定 的 经 验 ， 而 且 想 更 加 深入 地 了 解 Java 编 程 语言 ， 成 
8 a ue ane 那么 ， 建 议 你 用 心 的 研读 本 


内 容 形式 


本 书 分 为 11 章 共 78 个 条 目 ， 涵 盖 了 Java 5.0/6.0 的 种 种 技术 要 点 。 与 第 1 
版 相 比 ， 本 书 删除 了 “C 语 言 结构 的 蔡 代 ”一 章 ， 增 加 了 Java 5 所 引入 
的 “ 泛 型 ”\“ 枚 举 和 注解 ”各 一 章 。 数 量 上 从 57 个 条 目 发 展 到 了 78 个 ， 
不 仅 增加 了 23 个 条 目 ， 并 对 原来 的 所 有 资料 都 进行 了 全 面 的 修改 ， 删 
去 了 一 些 已 经 过 时 的 条 目 。 但 是 ， 各 章节 没有 严格 的 前 后 顺序 关系 ， 
你 可 以 随意 选择 感 兴趣 的 章节 进行 阅读 。 当 然 ， 如 果 你 想 马 上 知道 第 2 
版 究竟 有 哪些 变化 ， 可 以 参阅 附录 中 第 2 版 与 第 1 版 详细 的 对 照 情况 。 


本 书 重 点 讲述 了 Java 5 所 引入 的 全 新 的 泛 型 、 枚 举 、 注 解 、 目 动 装 箱 、 
for-each 循 环 、 可 变 参数 、 并 发 机 制 ， 还 包括 对 象 、 类 、 类 库 、 方 法 和 
序列 化 这 些 经 典 主题 的 全 新 技术 和 最 佳 实践 ， 如 何 避 人 免 Java 语 言 中 常 

被 误解 的 细微 之 处 : 陷阱 和 缺陷， 并 重点 关注 Java 语 言 本 号 和 最 基本 

的 类 库 : java.lang `~ java.util , 以 及 一 些 扩展 : java.util.concurrent 

和 java.io 等 等 Ss 


章节 简介 


第 2 章 阐 述 何 时 以 及 如 何 创建 对 象 ， 何 时 以 及 如 何 避 免 创 建 对 象 ， 如 何 
2 erie ee ne 
清除 动作 。 


第 3 章 曾 述 对 于 所 有 对 象 都 通用 的 方法 ， 你 会 从 中 获知 对 equals 
hashCode ` toString `~ clone 和 finalize 相当 深入 的 分 析 ， 从 而 避免 
今后 在 这 些 问题 上 再 次 犯错 。 


第 4 章 前 述 作为 Java 程 序 设计 语言 的 核心 以 及 Java 语 言 的 基本 抽象 单元 
(类 和 接口 ， 在 使 用 上 的 一 些 指导 原则 ， 帮 助 你 更 好 地 利用 这 些 元 
素 ， 设 计 出 更 加 有 用 、 健 壮 和 灵活 的 类 和 接口 。 


第 5 章 和 人 第 6 草 中 分 别 曾 述 在 Java 1.5 发 行 版 本 中 新 增加 的 泛 型 
(Generic) 以 及 枚 举 和 注解 的 最 佳 实践 ， 教 你 如 何 最 大 限度 地 享有 这 
些 优势 ， 又 能 使 整个 过 程 尽 可 能 地 简单 化 。 


第 7 章 讨论 方法 设计 的 几 个 方面 :如何 处 理 参数 和 返回 值 ， 如 何 设计 方 
EER. MPIRE C 。 从 而 在 可 用 人 性、 健壮 性 和 灵活 性 上 有 
一 步 的 提升 。 


第 8 章 主 要 讨论 Java 语 言 的 具体 细 方 ， 讨 论 了 局 部 变量 的 处 理 、 控 制 结 
构 、 类 库 的 使 用 、 各 种 数据 类 型 和 用 法 ， 以 及 两 种 不 是 由 语言 本 身 提 
供 的 机 制 (reflection 和 native method， 反 射 机 制 和 本 地 方法 ) 的 用 法 ， 
并 讨论 了 优化 和 命名 惯例 。 


SO ee Al A a] IR ACTER OL, Al per BeAr AY ay Sete > a) SEE 
和 可 维护 性 ， 以 及 减少 使 用 不 当 所 市 来 的 负面 有 影响。 并 提供 了 一 些 关 
于 有 效 使 用 异 第 的 知道 原则 。 


on ` 正确 、 文 档 组 织 良 好 的 并 发 程 
Y o 


PUBAW WAM, EAE alte RATE, Bt 


是 序列 化 代理 (serialization proxy) 模式 ， 它 可 以 帮助 你 避免 对 象 序 列 
化 的 许多 缺陷 。 


举 个 例子 ， 就 序列 化 技术 来 讲 ，HTTP 会 话 状态 为 什么 可 以 被 缓存 ? 
RMI 的 异常 为 什么 可 以 从 服务 端 传递 到 客户 端 呢 ?GUI 组 件 为 什么 可 
以 被 发 现 、 保 存 和 恢复 呢 ? 是 因为 他 们 实现 了 serializable 接口 吗 ? 
如 有 条 超 类 没有 提供 一 个 可 访问 的 无 参 构造 希 ， 它 的 子 类 可 以 被 序列 化 
吗 ? 当 一 个 实例 采用 默认 的 序列 化 形式 ， 并 且 给 某 些 域 标 记 为 
transient , 那么 当 实例 反 序 列 化 回来 后 ， 这 些 标志 为 transient 域 的 
值 各 是 些 什么 呢 ? ...... 这 些 问 题 如 果 你 现在 不 能 马上 回答 ， 或 者 不 不 
没有 关系 ， 仔 细 阅 读本 书 ， 你 会 对 它们 有 更 深入 与 透彻 的 
TEHE o 


技术 范围 


虽然 本 书 是 讨论 更 深层 次 的 Java 开 发 技术 ， 讲 述 的 内 容 深 入 ， 涉 及 面 

又 相当 广泛 ， 但 是 它 并 没有 涉及 图 形 用 户 界 面 编程 、 企 业 级 API 以 及 

e 不 过 在 各 个 草 世 与 条 目 中 会 不 时 地 讨论 到 其 他 
N 车 o 
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笑 、 设 计 优 民 的 程序 提出 了 最 实用 、 最 权威 的 指导 方针 ， 是 Java 开 发 
人 员 案 头 上 的 一 本 不 可 或 缺 的 参考 书 。 


本 书 由 我 组 织 进 行 翻 译 ， 第 1 章 到 第 8 章 由 杨森 伦 负 责 、 我 负责 前 言 、 
附录 以 及 第 9 革 到 第 11 章 的 翻译 ， 并 人 负责 本 书 所 有 章节 的 全 面 审 校 。 参 
与 翻译 和 审 校 的 还 有 : RE BKR ` EWE > BAR > SARA E 
Hk > PRA > BRAT > ERR > USCA > XIE Ks EEJ ` EX ` F 
兴 、 翟 育 明 、 黄 华 ， 在 此 深 表 感谢 。 


虽然 我 们 在 翻译 过 程 中 竭力 追求 信 、 达 、 雅 ， 但 限于 上 自身 水 平 ， 也 许 
仍 有 不 足 ， 还 望 各 位 读者 不 音 指 正 。 关 于 本 书 的 翻译 和 翻译 时 采用 的 
术语 表 以 及 相关 的 技术 讨论 大 家 可 以 访问 我 的 博客 
http://blog.csdn.net/YuLimin ， 也 可 以 发 送 邮 件 到 YuLimin@163.com 与 
我 交流 。 


在 这 里 ， 我 要 感谢 在 翻译 过 程 中 一 起 讨论 和 帮助 我 的 朋友 们 ， 他 们 

是 : ÆR, ABE, AHR, SEEM, WILNA RERA A 
草 晓 刚 ，Spring 中 文 站 创始 人 杨 戈 (Yanger) ，SpringSide 创 始 人 首 桦 
(江南 白衣 ) 和 来 自 宝 岛 台 湾 的 李 日 贵 (jini) 、 林 康 司 (koji) 、 林 


fR (caterpillar) ， 还 有 责任 编辑 陈 佳 媛 也 为 本 书 出 版 做 了 大 量 工 
作 ， 在 此 再 次 深 表 感谢 。 


快乐 分 诗 ， 实 践 出 真知 ， 最 后 ， 视 大 家 能 够 像 我 一 样 在 阅读 中 至 受 本 
书市 来 的 乐趣 ! 


Read a bit and take it out, then come back read some more. 


Tea 


z) 


2008 年 11 月 
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如 有 果 有 一 个 同事 这 样 对 你 说 , “我 的 配 侦 今天 晚上 在 家 里 制造 了 一 顿 不 
同 寻常 的 晚餐 ， 你 愿意 来 参加 吗 ? ” (Spouse of me, this night today 
manufactrures the unusual meal in a home. You will join?) 这 时 候 你 脑子 
里 可 能 会 浮现 起 三 件 事 情 : 第 一 ， 满 脑子 的 疑惑 ， 第 二 ， 天 语 肯 定 不 
是 这 位 同事 的 木鱼 ， 第 三 ， 同 事 是 在 邀请 你 参加 他 的 家 庭 晚宴 。 


如 果 你 曾经 学 习 过 第 二 种 语言 ， 并 且 笑 试 过 在 课堂 之 外 使 用 这 种 语 

言 ， 你 就 该 知道 有 三 件 事 情 是 必须 掌握 的 : 这 门 语言 的 结构 如 何 ( 语 
法 ) ， 如 何 命名 你 想 谈论 的 事物 〈 词 汇 ) ， 以 及 如 何以 惯用 和 高 效 的 
方式 来 表达 日 常 的 事物 (用 法 ) 。 在 课 笔 上 大 多 只 涉及 前 面 两 点 ， 当 
你 古 出 浑身 解数 想 让 对 方 明日 你 的 意思 时 ， 常 常会 发 现 当 地 人 对 你 的 


表述 忍俊不禁 。 


程序 设计 语言 也 是 如 此 。 你 需要 理解 语言 的 核心 ， 它 是 面 问 算法 的 ， 
还 是 面 癌 画 数 的 ， 或 者 是 面 癌 对 象 的 ? 你 需要 知道 词汇 表 : 标准 类 库 
提供 了 哪些 数据 结构 、 操 作 和 功能 (Facility) ? 你 还 需要 熟悉 如 何 用 
习惯 和 高 效 的 方式 来 构建 代码 。 关 于 程序 设计 语言 的 书籍 通常 只 且 设 
计 前 面 两 点 ， 或 者 只 是 晴 凤 点 水 般 地 介绍 一 下 用 法 。 也 许 是 因为 前 面 
两 点 比较 容易 编写 。 语 法 和 词汇 是 语言 本 身 固有 的 特性 ， 但 是 ， 用 法 
则 反映 了 使 用 这 1 门 语言 的 群体 的 特征 。 


例如 ，Java 程 序 设 计 语 言 是 一 门 支 持 单 继承 的 面向 对 象 程序 设 计 语 
言 ， 在 每 个 方法 的 内 部 ， 它 也 支持 命令 式 的 (面向 语句 的 ，Statement- 


Oriented) 编码 风格 。Java 类 库 提供 了 对 图 形 显示 、 网 络 、 分 布 式 计算 
en o 但是， 如 何 把 这 门 语言 以 最 佳 的 方式 运用 到 实践 中 
Vig 


还 有 一 点 : 程序 与 口语 中 的 句子 以 及 大 多 数 书籍 和 杂志 都 不 同 ， 它 会 
酬 着 时 间 的 推移 而 发 生变 化 。 仅 仅 编 写 出 能 够 有 效 地 工作 并 且 能 够 被 
别人 理解 的 代码 往往 是 不 够 的 ， 我 们 还 必须 把 代码 组 织 成 易于 修改 的 
形式 。 针 对 某 个 任务 可 能 会 有 10 种 不 同 的 编码 方法 ， 而 在 这 10 中 方法 
中 ， 有 7 中 方法 是 笨拙 的 、 低 效 的 或 者 是 难以 理解 的 。 而 在 璋 下 的 3 种 
ee 哪 一 种 会 是 最 接近 该 任务 的 下 一 年 度 发 行 版 本 的 代码 
ie 


目前 有 大 量 的 书籍 可 以 供 你 学 习 Java 程 序 设计 语言 的 语法 ， 包 括 《The 
Java Programming Language》[Arnold05] (作者 Arnold、Gosling 和 
Holmes) ， 以 及 《The Java Language Specification) [JLS] (作者 
Gosling、Joy 和 Bracha) 。 同 样 ， 与 Java 程 序 设计 语言 相关 的 类 库 和 
API 的 书籍 也 不 少 。 


本 书 解 决 了 你 的 第 三 种 需求 :习惯 和 高 效 的 用 法 。 作 者 Joshua Bloch 在 
Sun 公 司 多 年 来 一 直 从 事 Java 语 言 的 扩展 、 实 现 和 使 用 的 工作 ; 他 还 大 
量 地 阅读 了 其 他 人 的 代码 ， 包 括 我 的 代码 。 他 在 本 书 中 提出 了 许多 很 
好 的 建议 ， 他 系统 地 把 这 些 建 议 组 织 起 来 ， 旨 在 告诉 读者 如 何 更 好 地 
构造 代码 以 便 它们 能 工作 得 更 好 ， 也 便于 其 他 人 能 够 理解 这 些 代 码 ， 
便于 将 来 对 代码 进行 修改 和 改善 的 时 候 不 至 于 那么 头疼 。 甚 至 ， 你 的 
程序 也 会 因此 而 变 得 更 加 令 人 愉悦 、 更 加 优美 和 雅致 。 


Guy L. Steele Jr. 


Burlington, Massachusetts 


2001 年 4 月 
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目 从 我 于 2001 年 写 了 本 书 的 第 1 版 之 后 ，Java 平 台 又 发 生 了 很 多 变化 ， 
征 该 出 第 2 版 的 时 候 了 。Java 5 中 最 为 重要 的 变化 是 增加 了 泛 型 、 枚 举 
类 型 、 注 解 、 目 动 闭 箱 和 foreach 循 环 。 其 次 是 增加 了 狐 的 并 发 类 库 : 


_java.util.concurrent 9 我 和 Gilad Bracha 一 起 ， Ae AMIGA It T ae 
新 的 语言 特性 。 我 还 有 幸 参 加 了 设计 和 开发 并 发 类 库 的 团队 ， 这 个 团 
队 由 Doug Lea 领 导 。 


Java 平 台中 男 一 个 大 的 变化 在 于 广泛 采用 了 现代 IDE (Integrated 
Development Environment) ， 例 如 Eclipse、IntelliJ IDEAJ NetBeans, 
以 及 静态 分 析 工 具 的 IDE， 如 FindBugs。 虽 然 我 还 未 参与 到 这 部 分 工 
作 ， 但 已 经 从 中 受益 菲 浅 ， 并 且 很 清楚 它们 对 Java 开 发 体验 所 市 来 的 


影响 。 


2004 年 ， 我 离开 Sun 公 司 到 了 Google 公 司 工作 ， 但 在 过 去 的 4 年 中 ， 我 

仍然 继续 参与 Java 平 台 的 开发 ， 在 Google 公 司 和 JCP (Java Community 

Process) 的 大 力 帮 助 下 ， 继 续 并 发 和 集合 API 的 开发 。 我 还 有 笠 利 用 

人 o 现在 我 了 解 了 作为 一 名 用 
JERS e 


RE20011 FS BURA IR, ERAN ET See, ET 
让 大 家 能 够 避免 我 所 走 过 的 弯路 ， 是 大 家 更 容易 成 功 。 新 版 仍然 采用 
大 量 来 目 Java 平 台 类 库 的 真实 范例 。 


第 1 版 所 市 来 的 反应 远 远 超 出 了 我 最 大 的 语气 。 我 在 收集 所 有 新 的 资料 
以 使 本 书 保持 最 狐 时 ， 尽 可 能 地 保持 了 痪 料 的 真实 。 军 无 疑问 ， 本 书 
的 篇 幅 肯定 会 增加 ， 从 57 个 条 目 发 展 到 了 78 个 。 我 不 仅 增加 了 23 个 条 
目 ， 并 且 修 改 了 原来 的 所 有 资料 ， 并 删 去 了 一 些 已 经 过 时 的 条 目 。 在 
附录 中 ， 你 可 以 看 到 本 书 中 的 内 容 与 第 1 版 的 内 容 的 对 照 情况 。 


在 第 1 版 的 前 言 中 我 说 过 : Java 程 序 设计 语言 和 它 的 类 库 非 常 有 益 于 代 
码 质量 和 效率 的 提高 ， 并 且 使 得 用 Java 进 行 编码 成 为 一 种 乐趣 ° Java 5 
和 6 发 行 版 本 中 的 变化 是 好 事 ， 也 使 得 Java 平 台 日 趋 完善 。 现在 这 个 平 
台 比 2001 年 的 要 大 得 多 ， 也 复杂 得 多 ， 但 是 一 旦 掌握 了 使 用 痢 特 性 的 
模式 和 习惯 用 法 ， 它 们 束 会 使 你 的 程序 变 得 更 完美 ， 使 你 的 工作 变 得 
更 轻松 。 我 布 望 第 2 版 能 够 体现 出 我 对 Java 平 台 持 续 的 热情 ， 并 将 这 种 
eee 帮助 你 更 加 高 效 和 和 愉快 地 使 用 Java 平 台 及 其 新 的 特 
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第 2 章 创建 和 销毁 对 象 


本 章 的 主题 是 创建 和 销毁 对 象 : 何 时 以 及 如 何 创 建 对 象 ， 何 时 以 及 如 
何 避 人 免 创建 对 象 ， 如 何 确保 它们 能 够 适时 地 销毁 ， 以 及 如 何 管理 对 象 
销 蝶 之 前 必须 进行 的 各 种 清理 动作 。 


第 1 条 : 考虑 使 用 静态 工厂 方法 代替 构 
对 于 类 而 言 ， 为 了 让 客户 端 获取 它 目 喘 的 一 个 实例 ， 最 常用 的 方法 就 
是 提供 一 个 公有 的 构造 希 。 还 有 一 种 方法 ， 也 应 该 在 每 个 程序 员 的 工 
具 箱 中 占有 一 席 之 地 。 类 可 以 提供 一 个 公有 的 PAEL 7774 (static 
factory method) ， 它 只 是 一 个 返回 类 的 实例 的 静态 方法 。 下 面 是 一 个 
KA Boolean (基本 类 型 boolean 的 包装 类 ) 的 人 简单 示例 ogy ie 
将 boolean 基本 类 型 值 转换 成 了 一 个 Boolean 对 象 引 用 : 


public static Boolean valueOf ( boolean b) { 


return b ? Boolean.TRUE : Boolean.FALSE; 


注意 ， 静 态 工 厂 方法 与 设计 模式 [Gamma95，p.107] 中 的 工厂 方法 模式 
ER eee ain 
了 o 


类 可 以 通过 静态 工厂 方法 来 提供 它 的 客户 疾 ， 而 不 是 通过 构造 器 。 所 
供 静 态 工 三 方法 而 不 是 公有 的 构造 器， 这 样 可 以 具有 几 大 优势 。 


静态 工厂 方法 与 构造 器 不 同 的 第 一 大 优势 在 于 ， 它 具有 和 名称 。 如 果 构 
造 侨 的 参数 本 身 没 有 确切 地 拉 述 正 被 返回 的 对 象 ， 那 么 具有 适当 名 称 
的 静态 工厂 会 更 容易 使 用 ， 产 生 的 客户 端 代码 也 更 易于 阅读 。 例 如 ， 
构造 器 BigInteger(int, int, Random) 返回 的 BigInteger 可 能 为 素数 ， 如 果 
用 名 为 BigInteger.probablePrime 的 静态 工厂 方法 来 表示 ， 显 然 更 为 清 
楚 。 (1.4 的 发 行 版 本 中 最 终 增加 了 这 个 方法 。) 


一 个 类 只 能 有 一 个 带 有 指定 签名 的 构造 右 。 编 程 人 员 通 常 知 道 如 何 避 

开 这 一 限制 : 通过 提供 两 个 构造 占 ， 它 们 的 参数 列表 只 在 参数 类 型 的 

顺序 上 有 所 不 同 。 实 际 上 这 并 不 是 个 好 主意 。 面 对 这 样 的 API， 用 户 

永远 也 记 不 住 该 用 哪个 构造 器 ， 结 果 常 常会 调用 错误 的 构造 器。 并 

了 这 些 构 造 器 的 代码 时 ， 如 果 没 有 参考 类 的 文档 ， 往 往 
NAL AT ZS ° 


静态 工厂 方法 与 构造 器 不 同 的 第 二 大 优势 在 于 ， 不 必 在 每 次 调用 它们 
的 时 候 都 创建 一 个 新 对 象 。 这 使 得 不 可 变 类 〈 见 第 15 条 ) 可 以 使 用 预 
先 构建 好 的 实例 ， 或 者 将 构建 好 的 实例 缓存 起 来 ， 进 行 重复 利用 ， 从 
而 避免 创建 不 必要 的 重复 对 象 。 Boolean.valueof(boolean ) 方法 说 明了 这 
项 技术 : 它 从 来 不 创建 对 象 。 这 种 方法 类 似 于 r1yweightitst 
[Gamma95，p.195]。 如果 程 序 经 党 创建 相同 的 对 象 ， 并 且 创 建 对 象 的 
代价 很 高 ， 则 这 项 技术 可 以 极 大 地 提升 性 能 。 


静态 工厂 方法 能 够 为 重复 的 调用 返回 相同 的 对 象 ， 这 样 有 助 于 类 总 能 
严格 控制 在 某 个 时 刻 哪些 实例 应 该 存在 。 这 种 类 被 称 作 SPE 
(instance-controlled) 。 编 写实 例 受 控 类 有 几 个 原因 。 实 例 受 控 使 得 
类 可 以 确保 它 是 一 个 singleton ”( 见 第 3 条 ) 或 者 是 不 可 实例 化 的 ( 见 
第 4 条 ) 。 它 还 使 得 不 可 变 的 类 ( 见 第 15 条 ) 可 以 确保 不 会 存在 两 个 相 
等 的 实例 ， 即 当 且 仅 当 amw 的 时 候 才 有 aequalis) 为 true ° WR 

类 保证 了 这 一 点 ， 它 的 客户 端 就 可 以 使 用 -= 操作 符 来 代替 
equals(object) 方法 ， 这 样 可 以 提升 性 能 。 枚 举 ( enm ) 类 型 ( 见 第 
30 条 ) 保证 了 这 一 点 。 


静态 工厂 方法 与 构造 器 不 同 的 第 三 大 优势 在 于 ， 它 们 可 以 返回 原 返 回 
子 类 型 的 对 象 。 这样 我 们 在 选择 返回 对 象 的 类 时 就 有 了 更 
9 灵活 性 。 


这 种 灵活 性 的 一 种 应 用 是 ，API 可 以 返回 对 象 ， 同 时 又 不 会 使 对 象 的 
类 变 成 公有 的 。 以 这 种 方式 隐藏 实现 类 会 使 API 变 得 非常 简洁 。 这 项 


技术 适用 于 基于 接口 的 框架 (interface-based framework, i118 

条 ) ， 因 为 在 这 种 框架 中 ， 接 口 为 静态 工厂 方法 提供 了 自然 返回 类 
型 。 接 口 不 能 有 私有 方法 ， 因 此 按照 惯例 ， 接 口 type 的 静态 工厂 方 
法 放 在 一 个 名 为 types 的 不 可 实例 化 的 类 〈 见 第 4 条 ) 中 。 


例如 ，Java Collections Framework 的 集合 接口 有 32 个 便利 实现 ， 分 别提 
供 了 不 可 修改 的 集合 、 同 步 集合 等 等 。 几 乎 所 有 这 些 实现 都 通过 静态 

工厂 方法 在 一 个 不 可 实例 化 的 类 ( java.util.Collections ) 中 导出 2 所 

有 返回 对 象 都 的 类 是 非 公有 的 。 


现在 的 Java Collections Framework API 比 导出 32 个 独立 公有 类 的 那 种 实 
现 方式 要 小 得 多 ， 每 种 便利 实现 都 对 应 一 个 类 。 这 不 仅仅 是 指 API 数 

量 上 的 减少 ， 也 是 概念 意义 上 的 减少 。 用 户 知 道 ， 被 返回 的 对 象 是 由 
相关 的 接口 精确 指定 的 ， 所 以 他 们 不 需要 阅读 有 关 的 文档 。 使 用 这 种 
静态 工 上 方法 是 ， 甚 至 要 求 客 户 端 通过 接口 来 引用 被 返回 的 对 象 ， 而 
不 是 通过 它 的 实现 类 来 引用 被 返回 的 对 象 ， 这 是 一 种 民 好 的 习惯 ( 见 


第 52 条 ) 。 


共有 的 静态 工厂 方法 所 返回 的 对 象 的 类 不 仅 可 以 是 非 公 有 的 ， 而 且 该 
类 还 可 以 随 看 每 次 调用 而 发 生变 化 ， 这 取决 于 静态 工厂 方法 的 参数 
值 。 只 要 是 已 声明 的 返回 类 型 的 子 类 型 ， 都 是 允许 的 。 为 了 提升 软件 
ee 返回 对 象 的 类 也 可 能 随 着 发 行 版 本 的 不 同 而 不 


发 新 版 本 1.5 中 引入 的 类 java.util.EnumSet ( 见 第 32 条 ) 没有 公有 构造 
如 ， 只 有 静态 工厂 方法 。 它 们 返回 两 种 实现 烈性 之 一 ， 具 体 则 取决 于 
压 层 枚 举 类 型 的 大 小 ;如果 它 的 元 素 有 64 个 或 者 更 少 ， 就 像 大 多 数 榴 
举 类 型 一 样 ， 静态 工厂 方法 就 会 返回 一 人 1 RegularEnumSet 实例 ， 用 单 
long 进行 文 持 ， 如 果 枚 举 类 型 有 65 个 或 者 更 多 元 素 ， 工 厂 束 返回 
JumboEnumSet 实例 ， 用 long 数 组 进行 支持 。 


这 两 个 实现 类 的 存在 对 于 客户 端 来 说 是 不 可 见 的 。 如 果 reguiarenumset 
不 能 再 给 小 的 枚 举 类 型 提供 性 能 优势 ， 束 可 能 从 未 来 的 发 行 版 本 中 将 
它 删 除 ， 不 会 造成 不 恨 的 影响 。 同 样 地 ， 如 采 事 实证 明 对 性 能 有 好 
处 ， 也 可 能 在 未 来 的 发 行 版 本 中 添加 第 三 甚至 第 四 个 Enunset 实现 。 
客户 端 永 远 不 知道 也 不 关心 他 们 从 工 广 方 法 中 得 到 的 对 象 的 类 ;他们 
只 关心 它 是 EnumSet 的 某 个 子 类 即 可 


> 


静态 工厂 方法 返回 的 对 象 所 属 的 类 ， 在 编写 包含 该 静态 工厂 方法 的 类 

时 可 以 不 必 存 在 。 这 种 灵活 的 静态 工厂 方法 构成 孔 务 巡 估 者 旋 笑 
(Service Provider Framework) 的 基础 ， 例 如 JDBC (Java 数 据 库 连 

接 ， Java Databse Connectivity) API ° 服务 提供 者 框架 是 指 这 样 一 个 系 

Gi: 多 个 服务 提供 者 实现 一 个 服务 ， 系 统 为 服务 提供 者 的 客户 端 提 供 

多 个 实现 ， 并 把 他 们 从 多 个 实现 中 解 耦 出 来 。 


服务 提供 者 框架 中 有 三 个 重要 的 组 件 : 服务 接口 (Service 
Interface) ， 这 是 提供 者 实现 的 ;提供 者 注册 API (Provider 
Registration API) ， 这 是 系统 用 来 注册 实现 ， 让 客户 端 访 问 它 们 的 ; 
服务 访问 API (Service Access API) ， 是 客户 端 用 来 获取 服务 的 实例 
的 。 服 务 访问 API 一 般 允 许 但 是 不 要 求 客 户 端 指 定 某 种 选择 提供 者 的 
条 件 。 如 果 没 有 这 样 的 规定 ，API 豆 会 返回 默认 实现 的 一 个 实例 。 服 
务 访问 API 是 “灵活 的 静态 工厂 ”*， 它 构成 了 服务 提供 者 框架 的 基础 。 


服务 提供 者 框架 的 第 四 个 组 件 是 可 选 的 : 服务 提供 者 接口 (Service 
Provider Interface) ， 这 些 提供 考 负 责 创 建 其 服务 实现 的 实例 。 如 果 没 
有 服务 提供 者 接口 ， 实 现 束 按照 类 名 进行 注册 ， 并 通过 反射 方式 进行 
实例 化 ( 见 第 53 条 ) 。 对 于 JDBC 来 说 ， connection 就 是 它 的 服务 接 
口 ; DriverManager.registerDriver 是 提供 者 注册 APIL， 

DriverManager .getConnection 是 服务 访问 APL， Driver 就 是 服务 提供 者 接 
[Jo 


服务 提供 者 框 染 模式 有 着 无 数 种 变 体 。 例 如 ， 服 务 访问 API 可 以 利用 
适配器 (Adapter) 模式 [Gamma95，p.139]， 返 回 比 提供 者 需要 的 更 丰 
富 的 服务 接口 。 下 面 是 一 个 简单 的 实现 ， 包 含 一 个 服务 提供 者 接口 和 
一 个 默认 提供 者 : 


// Service provider framework sketch 


// Service interface 


public interface Service { 


// Service provider interface 


public interface Provider { 


Service newService () ; 


// Noninstantiable class for service registration and access 


public class Services { 


private Services () {} // Prevents instantiation (Item 4) 


// Maps service names to services 


private static final Map<String, Provider> providers = new 


ConcurrentHasMap<String, Provider>(); 


public static final String DEFAULT_PROVIDER_NAME = "<def>" ; 


// Provider registration API 


public static void registerDefaultProvider (Provider p) { 


registerProvider (DEFAULT_PROVIDER_NAME, p); 


public static void registerProvider (String name, Provider p) 


providers.put(name, p); 


// Service access API 


public static Service newInstance () { 


return newInstance(DEFAULT_PROVIDER_NAME) ; 


public static Service newInstance (String name) { 


Provider p = providers.get(name); 


if (p == null ) 


throw new IllegalArgumentException( 


"No provider registered with name: " + name); 


return p.newService(); 


静态 工厂 方法 的 第 四 大 优势 在 于 ， 在 创建 参数 化 类 型 实例 的 时 候 ， 它 
们 使 代码 变 得 更 加 简 尘 。 遗憾 的 是 ， 在 调用 参数 化 类 的 构造 器 时 ， 即 
使 关 型 参数 很 明显 ， 也 必须 指明 。 这 通常 要 求 你 接连 两 次 提供 类 型 参 


数 : 


Map<String, List<String>> m = new HashMap<String, List<String>>(); 


随 看 类 型 参数 变 得 越 来 越 长 ， 越 来 越 复 杂 ， 这 一 隐 长 的 说 明 也 很 快 变 
得 痛 否 起 来 。 但 是 有 了 静态 工 上 方法 ， 编 译 需 惑 可 以 奉 你 找到 类 型 参 
数 。z 和 被 称 作 类 型 推 到 (type inference) 。 例 如 ， 假 设 nasnwap 提供 
了 这 个 静态 工厂 : 


public static <K, V> HashMap<kK, V> newInstance () { 


return new HashMap<K, V>(); 


Anas AY DAFA F EA A tel RARE E TB Ik Bc RR A) E HH: 


Map<String, List<String>> m = HashMap.newInstance(); 


总 有 一 天 ，Java 能 够 在 构造 右 调 用 以 及 方法 调用 中 执行 这 种 类 型 推 
到 ， 但 到 发 行 版 本 1.6 为 止 暂 时 还 无 法 这 么 做 。 


遗憾 的 是 ， 到 发 行 版 本 1.6 为 止 ， 标 准 的 集合 实现 如 nasima 并 没有 工 
三 方法 ,但 是 可 以 把 这 些 方 法 放 在 你 目 己 的 工具 类 中 。 更 重要 的 是 ， 
可 以 把 这 样 的 静态 工厂 放 在 你 目 己 的 参数 化 的 类 中 。 


静态 工厂 方法 的 主要 缺点 在 于 ， 类 如 果 不 含 有 公有 的 或 者 受 保护 的 构 
造 器 ， 就 不 能 被 子 类 化 。 对 于 公有 的 静态 工厂 所 返回 的 非 公 有 类 ， 也 
同样 如 此 。 例 如 ， 要 想 将 Collections Framework 中 的 任何 方便 的 实现 类 
子 类 化 ， 这 是 不 可 能 的 。 但 是 这 样 也 许 会 因祸得福 ， 因 为 它 发 励 程 序 
员 使 用 复合 (composition) ， 而 不 是 继承 〈 见 第 16 条 ) ° 


静态 工厂 方法 的 第 二 个 缺点 在 于 ， 它 们 与 其 他 的 静态 方法 实际 上 没有 
任何 区 别 。 在 API 文 档 中 ， 它 们 没有 像 构 造 器 那样 在 API 文 档 中 明确 标 
识 出 来 ， 因 此 ， 对 于 提供 了 静态 工厂 方法 而 不 是 构造 器 的 类 来 说 ， 要 
想 查 明 如 何 实例 化 一 个 类 ， 这 有 征 非常 困难 的 。Javadoc 工 具 总 有 一 天 会 
注意 到 静态 工厂 方法 。 同 时 ， 你 通过 在 类 或 者 接口 注释 中 关注 静态 工 
三， 并 遵守 标准 的 命名 习惯 ， 也 可 以 弥补 这 一 务 势 。 下 面 是 静态 工厂 
方法 的 一 些 惯用 名 称 : 


® valueof 不 太 严 格 地 讲 ， 该 方法 返回 的 实例 与 它 的 参数 具有 
相同 的 值 。 这 样 的 静态 工厂 方法 实际 上 有 是 类 型 转化 方法 。 

of valueof 的 一 种 更 为 简洁 的 替代 ， 在 EnumSet ( 见 第 32 

条 ) 中 使 用 并 流行 起 来 。 

® getInstance 返回 的 实例 是 通过 方法 的 参数 来 摘 述 的 ， 但 是 不 

能 够 说 与 参数 具有 同样 的 值 。 对 于 singleton 来 说 ， 该 方法 没有 

参数 ， 并 返回 唯一 的 实例 。 

newInstance 象 getInstance FF, 但 newInstance 能 够 确保 返 

回 的 每 个 实例 都 邱 所 有 其 他 实例 不 同 。 

getType 像 getInstance = 但 是 在 工矿 方法 处 于 不 同 的 类 

中 的 时 候 使 用 。 Type 表示 工厂 方法 所 返回 的 对 象 类 型 。 

newType 像 newInstance =F, 但 是 在 工厂 方法 处 于 不 同 的 类 

中 的 时 候 使 用 。 Type 表示 工厂 方法 所 返回 的 对 象 类 型 。 


简 而 言 之 ， 议 态 工厂 方法 和 公有 构造 此 部 各 有 用 处 ， 我 们 需要 理解 它 
们 各 目的 长 处 。 询 人 态 工 厂 通 第 更 加 合适 ， 因 此 切忌 第 一 反应 就 古 提供 
公有 的 构造 厦 ， 而 不 先 考 虑 静态 工厂 。 


第 2 条 : 遇 到 多 个 构造 项 参数 时 要 考虑 
FAR tae 


静态 工厂 和 构造 器 有 个 共同 的 局 限 性 ， 它 们 都 不 能 很 好 地 扩展 到 大 量 
的 可 选 参 数 。 考 虚 用 一 个 类 表示 包 洲 食品 外 面 显示 的 营养 成 分 标签 。 
Eins PAIL ebm: BOSE > HS OR Bi 
卡路里 ， 还 有 超过 20 个 可 选 域 : 总 脂肪 量 、 饱 和 脂肪 量 、 转 化 脂肪 、 
胆固醇 、 钠 等 等 。 大 多 数 产 品 在 某 几 个 可 选 域 中 都 会 有 非 零 的 值 。 


对 于 这 样 的 类 ， 应 该 用 哪 种 构造 器 或 者 静态 方法 来 编写 呢 ? 程序 员 一 
HJARRES as (telescoping constructor) 模式 ， 在 这 种 模式 
下 ， 你 提供 第 一 个 只 有 必要 参数 的 构造 器 ， 第 二 个 构 造句 有 一 个 可 选 
参数 ， 第 三 个 有 两 个 可 选 参数 ， 以 此 类 推 ， 最 后 一 个 构造 器 包含 所 有 
可 选 参数 。 下 面 有 个 示例 ， 为 了 简单 起 见 ， 它 只 显示 四 个 可 rae 


// Telescoping constructor pattern - does not scale well! 


public class NutritionFacts { 


private final int servingSize; // (mL) required 
private final int servings; // (per container) required 
private final int calories; // optional 
private final int fat; // (g) optional 
private final int sodium; // (mg) optional 
private final int carbohydrate; // (g) optional 


public NutritionFacts ( int servingSize, int servings) { 


this (servingSize, servings, 0 ); 


public NutritionFacts ( int servingSize, int servings, int 


calories) { 


this (servingSize, servings, calories, © ); 


public NutritionFacts ( int servingSize, int servings, int 


calories, int fat) { 


this (servingSize, servings, calories, fat, 0 ); 


public NutritionFacts ( int servingSize, int servings, int 


calories, int fat, int sodium) { 


this (servingSize, servings, calories, fat, sodium, 0 ); 


public NutritionFacts ( int servingSize, int servings, int 


calories, int fat, int sodium, int carbohydrate) { 


this .servingSize = servingSize; 
this .servings = servings; 
this .calories = calories; 
this .fat = fat; 

this .sodium = sodium; 


this .carbohydrate = carbohydrate; 


SEROTEC MARR, MAASAR, (ZF 
中 包含 了 要 设置 的 所 有 参数 : 


NutritionFacts cocaCola = new NutritionFacts( 240, 8, 100, 0, 35, 
27 DE 


这 个 构造 器 调用 通常 需 要 许多 你 本 不 想 设 置 的 参数 ， 但 还 十 不 得 不 为 
他 们 传递 值 。 在 这 个 例子 中 ， 我 们 给 ta 传递 了 一 个 值 为 0。 如 果 “ 仅 
仅 ?” 征 这 6 个 参数 ， 看 起 来 还 不 算 太 粳 ， 问 题 是 随 着 参数 数目 的 增加 ， 
ERRIMAK TEH] o 


一 句 话 : HAMER RIIT, BESA WEERT, BOG 
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顺序 ， 编 译 器 也 不 会 出 错 ， 但 是 程序 在 运行 时 会 出 现 错误 的 行为 。 


过 到 许多 构造 参数 的 时 候 ， 还 有 第 二 种 代 蔡 办 法 ， 即 JavaBeans 模 式 ， 
在 这 种 模式 下 ， 调 用 一 个 无 参 构 造句 来 创建 队 形 ， 然 后 调用 setter 方 法 
来 设置 每 个 必要 的 参数 ， 以 及 每 个 相关 的 可 选 参数 : 


// JavaBeans Pattern - allows inconsistency, mandates mutability 


public class NutritionFacts { 


// Parameters initialized to default values (if any) 


private int servingSize = - 1 ; // Required; no default value 


private int servings =-1; // 


private int calories = 0; 


private int fat = 0; 


private int sodium = oE 


private int carbohydrate = 0 ; 

public NutritionFacts () {} 

// Setters 

public void setServingSize ( int val) { servingSize = val; } 
public void setServings ( int val) { servings = val; } 
public void setCalories ( int val) { calories = val; } 
public void setFat ( int val) { fat = val; } 

public void setSodium ( int val) { sodium = val; } 


public void setCarbohydrate ( int val) { carbohydrate = val; } 


APPR T EEEREN o THA, BEBE 


例 很 容易 ， 这 样 产生 的 代码 读 起 来 也 很 容易 : 
NutritionFacts cocaCola = new NutritionFacts(); 


cocaCola.setServingSize( 240 ); 


cocaCola.setServings( 8 ); 


cocaCola.setCalories( 100 ); 


cocaCola.setSodium( 35 ); 


cocaCola.setCarbohydrate( 27 ); 


遗憾 的 是 ，JavaBeans 模 式 上 自身 有 着 很 验证 的 缺点 。 因 为 构造 过 程 被 分 
到 了 几 个 调用 中 ， ÆFA E F JavaBean 可 能 从 无 不 一 致 鸭 状态。 类 
无 法 仪 仅 通 过 检验 构造 絮 参 数 的 有 效 性 来 保证 一 臻 性。 试图 使 用 处 于 
不 一 致 状态 的 对 象 ， 将 会 导致 失败 ， 这 种 失败 与 包含 错误 的 代码 大 相 
径 庭 ， 因 此 它 调试 起 来 十 分 困难 。 与 此 相关 的 另 一 点 不 足 在 于 ， 
JavaBeans fz it [FER MCT BRE 〈 见 第 15 条 ) ， 这 就 需 
要 程序 员 付出 额外 的 努力 来 确保 它 的 线程 安全 。 


当 对 象 的 构造 完成 ， 并 且 不 允许 在 解冻 之 前 使 用 时 ， 通 过 手工 “ 冻 
结 ? 对 象 ， 可 以 弥补 这 些 不 足 ， 但 是 这 种 方式 十 分 全 拙 ， 在 实践 很 少 使 
用 。 此 外 ， 它 长 至 会 在 运行 时 导致 错误 ， 因 为 编译 硕 无 法 确保 程序 员 
会 在 使 用 之 前 先 在 对 象 上 调用 freeze 方 法 。 


莽 运 的 是 ， 还 有 第 三 种 奉 代 方法 ， 既 能 保证 像 重 王 构 造 右 模式 那样 的 
安全 性 ， 也 能 保证 像 JavaBeans 模 式 那 么 好 的 可 读 性 。 这 了 束 是 Builder 模 
式 [Gamma95，p.97] 的 一 种 形式 。 不 直接 生成 想 要 的 对 象 ， 而 是 让 客 
户 端 利 用 所 有 必要 的 参数 调用 构造 器 (或 者 静态 工厂 ) ， 得 到 一 个 
builder 对 象 。 然 后 客户 端 调用 无 参 的 muild 方法 来 生成 不 可 变 的 对 
eee ( 见 第 22 条 ) > FEME 
它 的 示例 : 


// Builder Pattern 


public class NutritionFacts { 


private final int servingSize; 


private final int servings; 


private 


private 


private 


private 


public 


final 


final 


final 


final 


static 


int 


int 


int 


int 


class 


calories; 


fat; 


sodium; 


carbohydrate; 


Builder { 


// Required parameters 


private 


private 


final 


final 


int servingSize; 


int servings; 


// Optional parameters - initialized 


private int 


private int 


private int 


private int 


public 


calories = oe 
fat = 0; 
sodium zmo } 
carbohydrate = 0 ; 


this .servings 


Builder ( int servingSize, 


this .servingSize = servingSize; 


= servings; 


to default values 


int 


servings) 


{ 


public Builder calories ( int val) 


{ calories = val; return this 


public Builder fat ( int val) 


{ fat = val; return this 


public Builder sodium ( int val) 


{ sodium = val; return this 


public Builder carbohydrate ( int val) 


{ carbohydrate = val; return this 


public NutritionFacts build () { 


return new NutritionFacts( this ); 


private NutritionFacts (Builder builder) { 


servingSize = builder.servingSize; 


servings = builder.servings; 


calories = builder.calories; 
fat = builder.fat; 
sodium = builder .sodium; 


carbohydrate = builder.carbohydrate; 


注意 NutritionFacts 是 不 可 变 的 ， 所 有 的 默认 参数 值 都 单独 放 在 一 个 地 
方 。builder 的 setter 方 法 返回 builder 本 号 ， 以 便 可 以 把 调用 链接 起 来 。 
下 面 就 是 客户 端 代码 : 


NutritionFacts cocaCola = new NutritionFacts.Builder( 240, 8 ) 


.calories( 100 ).sodium( 35 ).carbohydrate( 27 ).build() 


这 样 的 客户 端 代码 很 容易 编写 ， 更 为 重要 的 是 ， 易 于 阅读 。 builderBe 
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builder 像 个 构造 絮 一 样 ， 可 以 对 其 参数 强加 约束 条 件 。 vuia 方法 可 
以 检验 这 些 约束 条 件 。 将 参数 从 builder 找 贝 到 对 象 中 之 后 ， 并 在 对 象 
域 而 不 十 builder 域 ( 见 第 39 条 ) 中 对 它们 进行 检验 ， 这 一 点 很 重要 。 
如 果 违 反 了 任何 约束 条 件 ， buil 方法 就 应 该 抛 出 
IllegalStateException (TL 8 60% ) 9 异常 的 详细 信息 应 该 显示 违反 了 
哪个 约束 条 件 ( 见 第 63 条 ) 。 


对 多 个 参数 强加 约束 条 件 的 男 一 种 方法 是 ， 用 多 个 setter 方 法 对 菜 个 约 
束 条 件 必 须 持 有 的 所 有 参数 进行 检查 。 如 采 该 约束 条 件 没有 得 到 满 
KE, setter 方 法 就 会 抛 出 IllegalArgumentsException ° 这 有 个 好 处 ， Wie 


anek as 立即 就 会 发 现 约束 条 件 失 败 ， 而 不 是 等 着 调用 
build {E ° 


与 构造 右 想 必 ，builder 模 式 的 略微 优势 在 于 ，builder 可 以 有 多 个 可 变 

(varargs) 参数 。 构 造 器 就 像 方法 一 样 ， 只 能 有 一 个 可 变 参数 。 因 为 
builder 利 用 单独 的 方法 来 设置 每 个 参数 ， 你 想 要 多 少 个 可 变 参数 ， 它 
们 就 可 以 有 多 少 个 ， 知 道 每 个 setter 方 法 都 有 一 个 可 变 参 数 。 


Builder 模 式 十 分 灵活 ， 可 以 利用 单个 builder 构 建 多 个 对 象 。builder 的 
参数 可 以 在 创建 对 象 期 间 进 行 调整 ， 也 可 以 随 着 不 同 的 对 象 而 改变 。 
builder 可 以 自动 填充 某 些 域 ， 例 如 每 次 创建 对 象 时 自动 增加 序列 号 。 


这 事 了 参数 的 builder 生 成 了 一 个 很 好 的 抽象 工厂 (Abstract Factory) 
[Gamma95，p.87]。 换 句 话说 ， 客 户 逆 可 以 将 这 样 一 个 builder 传 给 方 
法 ， 使 该 方法 能 够 为 客户 端 创建 一 个 或 者 多 个 对 象 。 要 使 用 这 种 用 
法 ， 需 要 有 个 类 型 来 表示 builder。 如 采 使 用 的 是 发 行 版 本 1.5 或 者 更 新 
版 本 ， 只 要 一 个 泛 型 〈 见 第 26 条 ) 就 能 满足 所 有 的 builder， 无 论 它 
们 在 构建 哪 种 类 型 的 对 象 : 


// A builder for objects of type T 
public interface Builder <T> £ 


public T build () ; 


注意 ， 可 以 声明 NutritionFacts.Builder 类 来 实现 Builder<NutritionFacts> 
[0] 


带 有 Builder 实 例 的 方法 通常 利用 有 限制 的 通配符 类 型 (bounded 
wildcard type， 见 第 28 条 ) 来 约束 构建 器 的 类 型 参数 。 例 如 ， 下 面 就 
ss 它 利 用 一 个 客户 端 提供 的 Builder 实 例 来 构建 
$ : 


Tree buildTree (Builder<? extends Node> nodeBuilder ) T aon f 


Java 中 传统 的 抽象 工厂 实现 是 Class WE, 用 newInstance 方法 充当 
build FEE EB S 这 种 用 法 隐 舍 着 许多 问题 ° newInstance 方法 总 
是 企图 调用 类 的 无 参 构 造 右 ， 这 个 构造 絮 甚 至 可 能 根本 不 存在 。 如 果 
类 没有 可 以 访问 的 无 参 构造 各 ， 你 也 不 会 收 到 编译 时 错 座 。 相 反 ， 客 
户 问 代码 必须 在 运行 时 处 理 InstantiationException 或 者 
mlegalaccessException ， 这 样 既 不 雅 观 也 不 方便 。 newrnstance 方法 还 会 
传播 由 无 参 构造 器 抛 出 的 任何 异常 ， 即 使 newtnstance 缺乏 相应 的 
throws 子 句 换 句 话说 ， Class.newInstance DEIR T Agi FAT A PE 
。 上 面 讲 过 的 Builder 接 口 弥补 了 这 些 不 足 。 


Builder 模 式 的 确 也 有 它 目 喘 的 不 足 。 为 了 创建 西 乡 ， 必 须 先 创建 它 的 
构建 血 。 昌 然 创建 构建 器 的 开销 在 实践 中 可 能 不 那么 明显 ,但 十 在 某 
些 十 分 注重 性 能 的 情况 下 ， 可 能 惑 成 问题 了 。Builder 模 式 还 比重 县 构 
造 器 更 加 见长 ， 因 此 它 只 有 在 很 多 参数 的 时 候 才 使 用 ， 比 如 4 个 或 者 更 
多 个 参数 。 但 是 记 住 ， 将 来 你 可 能 需要 添加 参数 。 如 有 果 一 开始 束 使 用 
构造 右 或 者 静态 工厂 ， 等 到 类 需要 多 个 参数 时 才 添 加 构建 囊 ， 束 会 无 
法 控制 ， 那 些 过 时 的 构造 絮 或 者 静态 工厂 显得 十 分 不 协调 。 因 此 ， 通 
利 最 好 一 开始 殉 使 用 构建 着 。 


简 而 言 之 ， WRANMGBRa EEL! PARRA TER, wit 
类 计 ，Builder 顶 式 束 怎 劝 不 链 鸣 选任 ， 特 别 是 当 大 多 数 参数 都 是 可 选 
的 时 候 。 与 使 用 传统 的 重 玲 构造 器 模式 相 比 ， 使 用 Builder 模 式 的 客户 

端 代码 将 更 易于 阅读 和 编写 ， 构 建 右 也 比 JavaBeans 更 加 安全 。 


第 3 条 : 用 私有 构造 器 或 者 枚 举 类 型 强 
化 Singleton 属 性 


Singleton 指 仅仅 被 实例 化 一 次 的 类 [Gamma95，P.127]。Singleton 通 常 

被 用 来 代表 那些 本 质 上 唯一 的 系统 组 件 ， 比 如 窗口 管理 器 或 者 文件 系 
Bic (ERA ASingleton EECA ini he FAA, ANTE 
给 Singleton 蔡 换 模拟 实现 ， 除 非 它 实 现 一 个 充当 其 类 型 的 接口 。 

在 Java 1.5 发 行 版 本 之 前 ， 实 现 Singleton 有 两 种 方法 。 这 两 种 方法 都 要 
把 构造 大 保持 为 私有 的 ， 并 导出 共有 的 静态 成 员 ， 一 遍 人 允许 客户 端 能 
够 访问 该 类 的 唯一 实例 。 在 第 一 种 方法 中 ， 公 有 静态 成 员 是 个 final 


A 。 


// Singleton with public final field 
public class Elvis { 
public static final Elvis INSTANCE = new Elvis(); 


private Elvis () eee 


public void leaveTheBuilding () fo gan tf 


私有 构造 万 仅 被 调用 一 次 ， 用 来 实例 化 公有 的 静态 final 域 
Elvis.INSTANCE ° 由 于 缺少 公有 的 或 者 受 保护 的 构造 器 ， 所 以 保证 了 
elvis 的 全 局 唯一 性 : 一 旦 evis 类 被 实例 化 ， 员 会 存在 一 个 Elvis 
实例 ， 不 多 也 不 少 。 客 户 端的 任何 行为 都 不 会 改变 这 一 点 ， 但 要 提醒 
享有 特权 的 客户 ag PI 以 借助 AccessibleObject.setAccessible 方法 ， 
通过 反射 机 制 ( 见 第 53 条 ) 调用 私有 构造 器 。 如 果 需 要 抵御 这 种 攻 
A 可 以 修改 构造 器 ， 让 它 在 被 要 求 创建 第 二 个 实 实例 的 时 候 创建 异 
名 o 


在 实现 singleton 的 第 二 种 方法 中 ， 公 有 的 成 员 是 个 静态 工厂 方法 : 
// Singleton with static factory 
public class Elvis { 
private static final Elvis INSTANCE = new Elvis(); 
private Elvis () {... } 


public static Elvis getInstance () { return INSTANCE } 


public void leaveTheBuilding () {aaa tt 


XS FEAT IE Elvis.getInstance 的 所 有 调用 ， 都 会 返回 同一 个 对 象 引 
用 ， 所 以 ， 永 远 不 会 创建 其 他 的 evis 实例 (上述 提 醒 依 然 适用 ) 


公有 域 方法 的 主要 好 处 在 于 ， 组 成 类 的 成 员 的 声明 很 清楚 地 表明 了 这 
个 类 是 一 个 Singleton: 公有 的 静态 域 是 tina 的 ， 所 以 该 域 总 是 包含 
相同 的 对 象 引 用 。 公 有 域 方法 在 性 能 上 不 再 有 任何 优势 ， 现 代 的 JVM 

(Java 虚 拟 机 ，Java Virtual Machine) 实现 几乎 都 能 够 将 静态 工厂 方法 
的 调用 内 联 化 。 


工厂 方法 的 优势 之 一 在 于 ， 它 提供 了 灵活 性 : 在 不 改变 其 API 的 前 提 
下 ， 我 们 可 以 改变 该 类 是 否 应 该 为 Singleton 的 想法 。 工 厂 方法 返回 该 
类 的 唯一 实例 ， 但 是 ， 它 可 以 很 容易 被 修改 ， 比 如 改 成 为 每 个 调用 该 
方法 的 线程 返回 一 个 唯一 的 实例 。 第 二 个 优势 与 泛 型 〈 见 第 27 条 ) 有 
eee public 域 (public-field) 的 方法 比 


为 了 使 利用 这 其 中 一 种 方法 实现 的 Singleton 类 变 成 是 可 序列 化 的 ( 
Serializable ) ( 见 第 11 章 ) 仅仅 在 声明 中 加 上 * implements 
Serializable ”是 不 够 的 。 为 了 维护 并 保证 Singleton , 必须 声明 所 有 实例 
域 都 是 瞬时 ( transient ) 的 ， 并 提供 一 个 readResolve Fist ( 见 第 77 
R) 。 和 否则 ， 每 次 反 序 列 化 一 个 序列 化 的 实例 时 ， 都 会 创建 一 个 新 的 
实例 ， 比 如 说 ， 在 我 们 的 例子 中 ， 会 导致 "假冒 的 Elvis”。 为 了 防止 这 
种 情况 ， 要 在 evis 类 中 加 入 下 面 这 个 readresolve 方法 : 


// readResolve method to preserve sigleton property 


private Object readResolve () { 


// Return the one true Elvis and let the garbage collector 


// take care of the Elvis impersonator. 


return INSTANCE; 


从 Java 1.5 发 行 版 本 起 ， 实 现 Singleton 还 有 第 三 种 方法 。 只 需 编 写 一 个 
包含 单个 元 素 的 枚 举 类 型 . 


Enum singleton - the prefered approach 
public enum Elvis { 


INSTANCE, 


public void leaveTheBuilding () {i cere Y 


这 种 方法 在 功能 上 与 公有 方法 相近 ， 但 是 它 更 加 人 简洁， 无 偿 地 提供 了 
序列 化 机 制 ， 绝 对 防止 多 次 实例 化 ， 即 使 在 面 对 复杂 的 序列 化 或 者 反 
射 攻 击 的 时 候 。 虽 然 这 种 方法 还 没有 广泛 采用 ， 但 是 POC RATER 
Æ BARI EMSingleton hI RIEJ IE ° 


第 4 条 : 通过 私有 构造 器 强化 不 可 实例 
化 的 能 力 


有 时 候 ， 你 可 能 需要 编写 只 包含 静态 方法 和 静态 域 的 类 。 这 些 类 的 名 
声 很 不 好 ， 因 为 有 些 人 在 面向 对 象 的 语言 中 滥用 这 样 的 类 来 编写 过 程 
化 的 程序 。 尽 管 如 此 ， 它 们 也 确实 有 它们 特有 的 用 处 。 我 们 可 以 利用 
这 种 类 ， 以 java.lang.Math 或 者 java.util.Arrays 的 方式 ， 把 基本 类 型 的 
值 或 数组 类 型 上 的 相关 方法 组 织 起 来 。 我 们 也 可 以 通过 
java.util.Collections 的 方式 ， 把 基 实 现 特定 接口 的 对 象 上 的 静态 方法 


(包括 工厂 方法 ， 见 第 1 条 ) 组 织 起 来 。 最 后 ， 还 可 以 利用 这 种 类 把 
final 类 上 的 方法 组 织 起 来 ， 以 取代 扩展 该 类 的 做 法 。 


这 样 的 工具 类 (utility class) 不 希望 被 实例 化 ， 实 例 对 它 没 有 任何 意 
义 。 然 而 ， 在 缺少 显 式 构造 絮 的 情况 下 ， 编 译 絮 会 自动 提供 一 个 公有 
的 、 无 参 的 缺 省 构造 器 (default constructor) 。 对 于 用 户 而 言 ， 这 个 构 
造 占 与 其 他 的 构造 絮 没 有 任何 区 别 。 在 已 发 行 的 API 中 常常 可 以 看 到 
一 些 被 无 意识 地 实例 化 的 类 。 
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该 类 可 以 被 子 类 化 ， 并 且 该 子 类 也 可 以 被 实例 化 。 这 样 做 甚至 会 误导 
用 户 ， 以 为 这 种 类 是 专门 为 了 继承 而 设计 的 〈 见 第 17 条 ) 。 然 而 ， 有 
一 些 人 简单 习惯 用 法 可 以 确保 类 不 可 被 实例 化 。 由 于 只 有 当 类 不 包含 显 
式 的 构造 器 时 ， 编 译 絮 才 会 生成 缺 省 的 构造 器 ， 因 此 我 们 只 要 让 这 个 
类 包含 私有 构造 侨 ， 它 就 不 能 锌 实例 化 了 : 


// Noninstantiable utility class 


public class UtilityClass { 


// Suppress default constructor for noninstantiability 


private UtilityClass () { 


throw new AssertionError(); 


. // Remainder omitted 


由 于 显 式 的 构造 器 是 私有 的 ， 所 以 不 可 以 在 该 类 的 外 部 访问 它 。 
AssertionError 不 是 必需 的 ， 但 是 它 可 以 避免 不 小 心 在 类 的 内 部 调用 构 
造 器 。 它 保证 该 类 在 任何 情况 下 都 不 会 被 实例 化 。 这 种 习惯 用 法 有 点 
违背 直觉 ， 好 像 构造 器 就 是 专门 设计 成 不 能 被 调用 一 样 。 因 此 ， 明 短 
的 做 法 就 是 在 代码 中 增加 一 条 注释 ， 如 上 所 示 。 


这 种 习惯 用 法 也 有 副作用 ， 它 使 得 一 个 类 不 能 被 子 类 化 。 所 有 的 构造 
器 都 必须 显 式 或 隐 式 地 调用 超 类 (superclass) 构造 器 ， 在 这 种 情形 
下 ， 子 类 就 没有 可 访问 的 超 类 构造 器 可 调用 了 。 


` D 
第 5 条 : 避免 创建 不 必要 的 对 象 
一 般 来 说 ， 最 好 能 重用 对 象 而 不 是 在 每 次 需要 的 时 候 惑 创建 一 个 相同 
功能 的 新 对 象 。 重 用 方式 既 快 速 ， 又 流行 。 如 有 宁 对 象 是 不 可 变 的 
(immutable) 《〈 见 第 15 条 ) ， 它 就 始终 可 以 被 重用 。 


作为 一 个 极端 的 反面 例子 ， 考 虑 下面 的 语句 : 


String s = new String( "stringette" ); // DON'T DO THIS ! 


该 语句 每 次 被 执行 的 时 候 都 创建 一 个 新 的 string 实例 ， 但 是 这 些 创建 
对 和 象 的 动作 全 都 是 不 必要 的 。 传 递 给 string 构造 占有 的 参数 
(“stringette”) 本 号 吏 是 一 个 string 实例 ， 功 能 方面 等 同 于 构造 船 创 
建 的 所 有 对 象 。 如 打 这 种 用 法 是 在 一 个 循环 中 ， 或 者 是 在 一 个 被 频繁 
调用 的 方法 中 ， 束 会 创建 出 成 千 上 万 不 必要 的 string 实例 。 


改进 后 的 版 本 如 下 所 示 : 


String s = "stringette" ; 


这 个 版 本 只 用 了 一 个 string 实例 ， 而 不 是 每 次 执行 的 时 候 都 创建 一 个 
新 的 实例 。 而 且 ， 它 可 以 保证 ， 对 于 所 有 在 同一 台 虚 拟 机 中 运行 的 代 
码 ， 只 要 它们 包含 相同 的 字符 串 字面 常量 ， 该 对 象 束 会 被 重用 [JLS， 
3.10.5] ° 


WREST) TA 〈 见 第 1 条 ) APTA ANAT SESS, 
可 以 使 用 静态 工厂 方法 而 不 是 构造 右 ， 以 避免 创建 不 必 委 的 对 象 。 例 
如 ， 静态 工厂 方法 Boolean. valueOf (String) 几乎 总 是 优先 于 构造 器 
Boolean(String) 。 构 造 右 在 每 次 被 调用 的 时 候 都 会 创建 一 个 新 的 对 象 ， 
而 静态 工厂 方法 则 从 来 不 要 求 这 样 做 ， 实 际 上 也 不 会 这 样 做 。 


除了 重用 不 可 变 的 对 象 之 外 ， 也 可 以 重用 那些 已 知 不 会 被 修改 的 可 变 
对 象 。 下 面 是 一 个 比较 微妙 、 也 比较 常见 的 反面 例子 ， 其 中 涉及 可 变 
的 vate 对 象 ， 它 们 的 值 一 旦 计算 出 来 之 后 束 不 再 变化 。 这 个 类 建立 
了 一 个 模型 : 其 中 有 一 个 人 ， 并 由 一 个 isBabyBoomer 全 用 来 检验 
这 个 人 是 否 为 一 个 “baby boomer (生育 高 峰 期 出 生 的 小 孩 ) ”， 换 句 话 
说 ， 就 是 检验 这 个 人 是 否 出 生 于 1946 年 至 1964 年 期 间 。 


public class Person { 


private final Date birthDate; 


// Other fields, methods, and constructor omitted 
// DON'T DO THIS ! 
public boolean isBabyBoomer () { 
// Unnecessary allocation of expensive object 
Calendar gmtCal = 
Calendar .getInstance(TimeZone.getTimeZone( "GMT" )); 
gmtCal.set( 1946 , Calendar.JANUARY, 1, 9%, 0, 0); 
Date boomStart = gmtCal.getTime(); 
gmtCal.set( 1964 , Calendar.JANUARY, 1, 9%, ©, O); 
Date boomEnd = gmtCal.getTime(); 
return birthDate.compareTo(boomStart) >= 0 && 


birthdate.compareTo(boomEnd) < @ 


isBabyBoomer 每 次 被 调用 的 时 候 ， 都 会 新 建 一 个 Calendar ~*~ “| 
TimeZone 和 两 个 Date 实例 ， 这 是 不 必要 的 下 面 的 版 本 用 一 个 静态 
的 初始 化 器 (initializer) ， 避 免 了 这 种 效率 低下 的 情况 : 

public class Person { 


private final Date birthDate; 


// Other fields, methods, and constructor omitted 


* The starting and ending dates of the baby boom 


private static final Date BOOM_START; 


private static final Date BOOM_END; 


static { 
Calendar gmtCal = 
Calendar .getInstance(TimeZone.getTimeZone( "GMT" )); 


gmtCal.set( 1946 , Calendar.JANUARY, 1, 0, 0, 0O); 


BOOM_START = gmtCal.getTime(); 
gmtCal.set( 1964 , Calendar.JANUARY, 1, 0, 0, 0); 


BOOM_END = gmtCal.getTime(); 


public boolean isBabyBoomer () { 
return birthDate.compareTo(boomStart) >= 0 && 


birthdate.compareTo(boomEnd) < oO F 


改进 后 的 Person 类 只 在 初始 化 的 时 候 创 建 Calendar ` TimeZone 和 
Date 实例 一 次 ， 而 不 是 在 每 次 调用 isBabyBoomer 的 时 候 都 创建 这 些 实 
例 。 如 果 iseabygoomer 方法 征 频 楷 的 调用 ， 这 种 方法 将 会 显著 地 提高 
性 能 。 在 我 的 机 器 上 ， 每 调用 一 千 万 次 ， 原 来 的 版 本 需要 32000ms， 
而 改进 后 的 版 本 只 需要 130ms， 大 约 快乐 250 倍 。 除 了 提高 性 能 之 外 ， 
代码 的 含义 也 更 清晰 了 o 把 boomStart All boomEnd 从 局 部 变量 改 为 
final 静态 域 ， 这 些 日 期 显然 是 被 作为 音量 对 待 ， 从 而 使 得 代码 更 易 
于 理解 。 但 是 ， 这 种 优化 市 来 的 效果 并 不 总 是 那么 明显 ， 因 为 
Calendar 实例 的 创建 代价 特别 昂贵 ° 


如 果 改 进 后 的 Person 类 被 初始 化 了 ， 它 的 isBabyBoomer 方法 却 永 远 不 
会 被 调用 ， ATLA 必要 初始 化 BOOM_START 和 BOOM_END 域 通过 SIR 
初始 化 (lazy initializing) 《〈 见 第 71 条 ) ， 即 把 对 这 些 域 的 初始 化 延 
迟到 iseabygoomer 方法 第 一 次 被 调用 的 时 候 进 行 ， 则 有 可 能 消除 这 些 

不 必要 的 初始 化 工作 ， 但 是 不 建议 这 样 做 。 正 如 延 到 初始 化 中 常见 的 


情况 一 样 ， 这 样 做 会 使 方法 的 实现 更 加 复 洒 ， 从 而 无 法 将 性 能 显著 提 
高 到 超过 已 经 达到 的 水 平 ( 见 第 55 条 ) 


在 本 条 目前 面 的 例子 中 ， 所 讨论 到 的 对 象 显然 都 是 能 够 被 重用 的 ， 
为 它们 被 初始 化 之 后 不 会 再 改变 。 其 他 有 些 情 形 则 并 不 总 是 这 么 明显 
了 。 考 虑 ace? (adapter) 的 情形 [Gamma95，p. 139]， 有 时 也 叫做 
PEAT (view) 。 适 配器 是 指 这 样 一 个 对 象 : 它 把 功能 委托 给 一 个 后 
备 对 象 (backing object) ， 从 而 为 后 备 对 象 提供 一 个 可 以 替代 的 接 

口 。 由 于 适配器 除了 后 被 对 象 之 外 ， 没 有 其 他 的 状态 信息 ， 所 以 针对 
某 个 给 定 对 象 的 特定 适 配 絮 而 言 ， 它 不 需要 创建 多 个 适配器 实例 。 


例如 ， map 接口 的 keyset 方法 返回 该 map WRAY see 视图 ， 其 中 

包含 该 mp 中 所 有 的 键 (key) 。 粗 看 起 来 ， 好 像 每 次 调用 keyset 都 
应 该 创建 一 个 新 的 set 实例 ， 但 是 ， 对 于 一 个 给 定 的 map 对象 ， 实 
际 上 每 次 调用 keyset 都 返回 同样 的 set 实例 。 虽 然 被 返回 的 set Æ 
例 一 般 是 可 改变 的 ， 但 是 所 有 返回 的 对 象 在 功能 上 是 等 同 的 : 当 其 中 
一 个 返回 对 象 发 生变 化 的 时 候 ， 所 有 其 他 的 返回 对 象 也 要 发 生变 化 ， 

因为 她 们 是 由 同一 个 map 实例 文 撑 的 。 虽 然 创 建 keyset 视图 对 象 的 
多 个 实例 并 无 害处 ， 却 也 是 没有 必要 的 。 


在 Java 1.5 发 行 版 本 中 ， 有 一 种 创建 多 余 对 象 的 新 方法 ， 称 作 AIRIA 
( autoboxing ) ， 它 允许 程序 员 将 基本 类 型 和 装 箱 基 本 类 型 (Boxed 
Primitive Type) 混用 ， 按 需要 自动 装 箱 和 拆 箱 。 自 动 装 箱 使 得 基本 类 
型 和 装 箱 基本 类 型 之 间 的 差别 变 得 模糊 起 来 ， 但 是 并 没有 完全 消除 。 
它们 在 语义 上 还 是 有 着 微妙 的 差别 ， 在 性 能 上 也 有 着 比较 明显 的 差别 
( 见 第 49 条 ) 。 考 虑 下 面 的 程序 ， 它 计算 所 有 int 正 值 的 总 和 。 为 
long 算法 ， 因 为 int 不 够 大 ， 无 法 容纳 所 有 int 
Je H: 


// Hideously slow program! Can you spot the object creation? 
public static void main (String[] args) { 
Long sum = 0 ; 


for ( long i= 0 ; i < Integer.MAX_VALUE; i++) { 


sum += i; 


} 


System.out.printin(sum); 


这 上 段 程序 算出 的 答案 是 正确 的 ， 但 是 比 实际 情况 要 更 修一 些 ， 只 因为 
打 错 了 一 个 字符 。 变 量 sm 被 声明 成 tong MA tong ， 意 味 着 程 
序 构造 了 大 约 $$2^A{31}$$ 个 多 余 的 tong 实例 (大 约 每 次 往 Long sum 
中 增加 long 时 构造 一 个 实例 ) 。 将 sum 的 声明 从 Long 改 成 long 
， 在 我 的 机 右上 使 运行 时 间 从 43 秒 减少 到 了 6.8 秒 。 结 论 很 明显 : 要 从 
先 全 用 其 本 关 型 厅 不 十 类 箔 其 相关 型 ， 要 当心 无 局 识 的 自动 类 第 。 


不 要 错误 地 认为 本 条 目 所 介绍 的 内 容 上 暗示 着 “创建 对 象 的 代价 非常 昂 
贵 ， 我 们 应 该 要 尽 可 能 地 避免 创建 对 象 *”。 相反， 由 于 小 对 象 的 构造 句 
只 做 很 少量 的 显 式 工作 ， 所 以 ， 小 对 象 的 创建 和 回收 动作 是 非常 廉价 
的 ， 竺 别 是 在 现代 的 JVM 实 现 上 更 是 如 此 。 通 过 创建 附加 的 对 象 ， 提 
升 程序 的 清晰 性 、 人 简洁 性 和 功能 性 ， 这 通常 是 件 好事 。 


反之 ， 通 过 维护 自己 的 YR (object pool) 来 避免 创建 对 象 并 不 是 
一 种 好 的 做 法 ， 除 非 池 中 的 对 象 是 非常 重量 级 的 。 真 正 正确 使 用 对 象 
池 的 典型 正确 示例 驶 是 数据 库 连 接 池 。 建 立 数据 库 连 接 的 代价 是 非常 
昂贵 的 ， 因 此 重用 这 些 对 象 非 常 有 意义 。 而 且 ， 数 据 库 的 许可 可 能 限 
制 你 只 能 使 用 一 定数 量 的 连接 。 但 是 ， 一 般 而 言 ， 维 护 目 己 的 对 象 池 
必定 会 把 代码 乔 得 很 乱 ， 同 时 增加 内 存 占 用 (footprint) ， 并 且 还 会 损 
害 性 能 。 现 代 的 JVM 实 现 具 有 高 度 优 化 的 垃圾 回收 絮 ， 其 性 能 很 容易 
就 会 超过 轻 量 级 对 象 池 的 性 能 。 


与 本 条 目 对 应 的 是 第 39 条 中 有 关 “ CRIP PEPE (defensive copying 

) ”的 内 容 。 本 条 目 提 及 “ 当 你 应 该 重用 现 有 对 象 的 时 候 ， 请 不 要 创建 
源 的 对 象 ”， 而 第 39 条 则 说 <“ 当 你 应 该 创建 新 对 象 的 时 候 ， 请 不 要 重用 
现 有 对 象 "。 注 意 ， 在 提倡 使 用 保护 性 拷贝 的 时 候 ， 因 为 重用 对 象 要 付 
出 的 代价 要 远 远 大 于 因 创建 重复 对 象 而 付出 的 代价 。 必 要 时 如 果 没 能 
实施 保护 性 拷贝 ， 将 会 导致 潜在 的 错误 和 安全 漏洞 ， 而 不 必要 的 创建 
对 象 则 只 会 影响 程序 的 风格 和 性 能 。 


第 6 条 : 消除 过 期 的 对 象 引用 


当 你 从 手工 管理 内 存 的 语言 (比如 C 或 C++) 转换 到 具有 垃圾 回收 功能 
的 的 语言 的 有 时候， 程序 员 的 工作 会 变 得 更 加 容易 ， 因 为 当 你 用 完了 对 
象 之 后 ， 它 们 会 被 目 动 回 收 。 当 你 第 一 次 经 历 对 象 回收 功能 的 时 候 ， 
会 觉得 这 和 傈 直 有 点 不 可 思议 。 这 很 容易 给 你 留 下 这 样 的 印象 ， 认 为 目 
己 不 再 需要 考虑 内 存 管理 的 事情 了 “。 其 实 不 然 。 


考虑 下 面 这 个 稍 单 的 栈 实 现 的 例子 : 


public class Stack { 


private Object[] elements; 


private int size = 0; 


private static final int DEFAULT_INITIAL_CAPACITY = 16 ; 


public Stack () { 


elements = new Object[DEFAULT_INITIAL_CAPACITY]; 


public void push (Object e) { 


ensureCapacity(); 


elements[size++] = e; 


public Object pop () { 
if (size == 0 ) 
throw new EmptyStackException(); 


return elements[--size]; 


AEX 
* Ensure space for at least one more element, roughly 


* doubling the capacity each time the array needs to grow. 


private void ensureCapacity () { 
if (elements.length == size) 


elements = Arrays.copayOf(elements, 2 * size + 1 ); 


这 段 程序 ( 它 的 泛 型 版 本 请 见 第 26 条 ) 中 并 没有 很 明显 的 错误 。 无 论 
如 何 测 试 ， 它 都 会 成 功 地 通过 每 一 项 测试 ， 但 是 这 个 程序 中 隐藏 着 一 
个 问题 。 不 严格 地 讲 ， 这 段 程 序 有 一 个 “内 存 泄露 ”*， 随 着 垃圾 回收 右 


活动 的 增加 ， 或 者 由 于 内 存 占用 的 不 断 增加 ， 程 序 性 能 的 降低 会 逐渐 
表现 出 来 。 在 极端 的 情况 下 ， 这 种 内 存 泄 露 会 导致 磁盘 交换 (Disk 
Paging) ， 甚 至 导致 程序 失败 ( outormemoryerror 错误 ) ， 但 是 这 种 失 
败 情 形 相 对 比较 少见 。 


那么 ， 程 序 中 哪里 发 生 了 内 存 泄 露 呢 ? 如 果 一 个 栈 先 是 增长 ， 然 后 再 
收缩 ， 那 么 ， 从 栈 中 弹出 来 的 对 象 将 不 会 被 当做 垃圾 回收 ， 即 使 使 用 
栈 的 程序 不 再 引用 这 些 对 象 ， 它 们 也 不 会 被 回收 。 这 是 因为 ， 栈 内 部 
维护 着 对 这 些 对 象 的 TAAS/AY (obsolete reference) 。 所 谓 的 过 期 引 
用 ， 是 指 永远 也 不 会 再 被 解除 的 引用 。 在 本 例 中 ， 凡 是 在 elements 数 
组 的 “活动 部 分 ”(active portion) 之 外 的 任何 引用 都 是 过 期 的 。 活 动 部 
分 是 指 elements 中 下 标 小 于 size 的 那些 元 素 。 


在 文 持 垃圾 回收 的 语言 中 ， 内 存 泄 露 是 很 隐蔽 的 〈 称 这 类 内 存 泄露 为 
FEB IRA RRA F (unintentional object retention) ”更 为 恰当 ) ° WR 
一 个 对 象 引 用 被 无 意识 地 保留 起 来 了 ， 那 么 ， 垃 圾 回收 机 制 不 仅 不 会 
处 理 这 个 对 象 ， 而 且 也 不 会 处 理 被 这 个 对 象 所 引用 的 所 有 其 他 对 象 。 

即使 只 有 少量 的 几 个 对 象 引 用 被 无 意识 地 保留 下 来 ， 也 会 有 许 许多 多 
ee 从 而 对 性 能 造成 潜在 的 重大 影 
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这 类 问题 的 修复 方法 很 简单 : 一 旦 对 象 引用 已 经 过 期 ， 只 需 清空 这 些 
引用 即 可 。 对 于 上 述 例 子 中 的 stack 类 而 言 ， 只 要 一 个 单元 被 弹出 
栈 ， 指 向 它 的 引用 就 过 期 了 。 pop 方法 的 修订 版 本 如 下 所 示 : 
public Object pop () { 
if (size == 0 ) 
throw new EmptyStackException(); 
Object result = elements[--size]; 


elements[size] = null ; // Eliminate obsolete reference 


return result; 


清空 过 期 引用 的 另 一 个 好 处 是 ， 如 采 它 们 以 后 又 被 错误 地 解除 引用 ， 
程序 束 会 立即 抛 出 NullPointerException FEE , 而 不 是 悄悄 地 错误 运行 下 
去 。 尽 快 地 检测 出 程序 中 的 错误 总 是 有 益 的 。 


当 程序 员 第 一 次 被 类 似 这 样 的 问题 困扰 的 时 候 ， 他 们 往往 会 过 分 小 

D: 对 于 每 一 个 对 象 引 用 ， 一 旦 程序 不 再 用 到 它 ， 就 把 它 清空 。 其 实 
这 样 做 既 没 必要 ， 也 不 古 我 们 所 期 望 的 ， 因 为 这 样 做 会 把 程序 代码 弄 
得 很 想 。 沪 会 对象 3/ 用 应 蛮 十 一 黎 例 外 ， 而 人 不 十 一 歼 规 汉 行 为 。 消 除 
过 期 引用 最 好 的 方法 是 让 包含 该 引用 的 变量 结束 其 生命 周期 。 如 有 果 你 
征 在 最 紧 恋 的 作用 域 范围 内 定义 每 一 个 变量 ( 见 第 45 条 ) ， 这 种 情形 
BLA BAM PAM ACE ° 


那么 ， 何 时 应 该 清空 引用 呢 ? stak 类 的 哪 方面 特性 使 它 易 于 遭受 内 
存 泄露 的 影响 呢 ? 简 而 言 之 ， 问 题 在 于 ， stc 类 AC RHA 
(manage its own memory) ° 不 锯 (storage pool) 包含 了 elements 
数组 《对 象 引 用 单元 ， 而 不 是 对 象 本 号 ) 的 元 素 。 数 组 活动 区 域 ( 同 
前 面 的 定义 ) 中 的 元 素 是 EACH (allocated) ， 而 数组 其 余部 分 的 
元 素 则 是 自由 的 (free) 。 但 是 垃圾 回收 器 并 不 知道 这 一 点 ， 对 于 垃 
圾 回收 器 而 言 ， elements 数组 中 的 所 有 对 象 引 用 都 同等 有 效 。 只 有 程 
序 员 知道 数组 的 非 活动 部 分 是 不 重要 的 。 程 序 员 可 以 把 这 个 情况 告知 
垃圾 回收 硕 ， 做 法 很 简单 : 一 旦 数组 元 素 变 成 了 非 活动 部 分 的 一 部 
分 ， 程 序 员 束 手 工 清空 这 些 数组 元 素 。 
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留 在 缓存 中 。 对 于 这 个 问题 ， 有 几 种 可 能 的 解决 方案 。 如 采 你 正好 要 
实现 这 样 的 缓存 ， 只 要 在 缓存 之 外 存在 对 某 个 项 的 键 的 引用 ， 该 项 束 
有 意义 ， 那 么 瑟 可 以 用 weaknashnan 代表 缓存 ; 当 缓存 中 的 项 过 期 后 ， 
它们 融会 目 动 被 删除 。 记 住 只 有 当 所 要 的 缓存 项 的 生命 周期 是 由 该 键 
的 外 部 引用 而 不 是 由 值 决定 时 ， weaknasnwap 才 有 用 处 。 


更 为 常见 的 情形 则 是 , “缓存 项 的 生命 周期 是 否 有 意义 ”并 不 是 很 容易 

确定 ， 随 着 时 间 的 推移 ， 其 中 的 项 会 变 得 越 来 越 没 有 价值 。 在 这 种 情 

况 下 ， 绥 存 应 该 时 不 时 地 清除 掉 没 用 的 项 。 这 项 消除 工作 可 以 由 一 个 

后 台 线 程 (可 能 是 Timer 或 者 ScheduledThreadPoolExecutor ) 来 完成 ， 或 
者 也 可 以 在 给 缓存 添加 新 条 目 的 时 候 顺 便 进 行 清 理 Q LinkedHashMap 类 

利用 它 的 removeEldestEntry 可 以 很 容易 地 实现 后 一 种 方案 对 于 更 加 复 
杂 的 缓存 ， 必 须 直 接 使 用 java.lang.ref 
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API， 窗 户 端 在 这 个 API 中 注册 回调 ， 却 没有 显 式 地 取消 注册 ， 那 么 除 
非 你 采取 某 些 动作 ， 否 则 它们 束 会 积聚 。 人 确保 回调 立即 被 当做 垃圾 回 
收 的 最 佳 方法 是 只 保存 它们 的 S75/A (weak reference) ， 例 如 ， 只 
将 它们 保存 成 WeakHashMap 中 的 键 R 
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中 存在 很 多 年 。 往 往 只 有 通过 仔细 检查 代码 ， 或 者 借助 于 Heap 痢 析 工 
H. (Heap Profiler) 才能 发 现 内 存 泄漏 问题 。 因 此， 如 果 能 够 在 内 存 泄 
漏 发 生 之 前 束 知 道 如 何 预测 此 类 问题 ， 并 阻止 它们 发 生 ， 那 是 最 好 不 


过 的 了 


第 7 条 : 避免 使 用 终结 方法 


KATIA (finalizer) ire Th WOH, thier, Ahio 下 
在 不 必要 的 。 使 用 终结 方法 会 导致 行为 不 稳定 、 降 低 性 能 ， 以 及 可 移 
植 性 问题 。 当 然 ， 终 结 方法 也 有 其 可 用 之 处 ， 我 们 将 在 本 条 目的 最 后 

再 做 介绍 ; 但 是 根据 经 验 ， 应 该 避免 使 用 终结 方法 。 


C++ 的 程序 员 被 告知 “不 要 把 终结 方法 当 作 是 C++ 中 的 析 构 咽 
(destructor) 的 对 应 物 ”。 在 C++ 中 ， 析 构 器 是 回收 一 个 对 象 所 占用 资 
源 的 常规 方法 ， 是 构造 絮 所 必需 的 对 应 物 。 在 Java 中 ， 当 一 个 对 象 变 
得 不 可 到 达 的 时 候 ， 垃 圾 回收 旨 会 回收 与 该 对 象 相关 联 的 存储 空间 ， 
并 不 需要 程序 员 做 专门 的 工作 。C++ 的 析 构 器 也 可 以 被 用 来 回收 其 他 
的 非 内 存 资源 。 而 在 Java 中 ， 一 般 用 try-finally 块 来 完成 类 似 的 工作 。 


终结 方法 的 缺点 在 于 不 能 你 证 会 被 及 时 地 执行 [JLS，12.6]。 从 一 个 对 
象 变 得 不 可 到 达 开 始 ， 到 它 的 终结 方法 被 执行 ， 所 花费 的 这 段 时 间 是 
任意 长 的 。 这 意味 着 ， 注 重 时 间 (time-critical) 的 任务 不 应 该 由 终结 


方法 来 完成 。 例 如 ， 用 终结 方法 来 天 闭 已 经 打开 的 文件 ， 这 十 严重 错 
误 ， 因 为 打开 文件 的 描述 符 是 一 种 很 有 限 的 资源 。 由 于 JVM 会 延迟 执 
行 终结 方法 ， 所 以 大 量 的 文件 会 保留 在 打开 状态 ， 当 一 个 程序 再 不 能 
打开 文件 的 时 候 ， 它 可 能 会 运行 失败 。 


及 时 地 执行 终结 方法 正 是 垃圾 回收 算法 的 一 个 主要 功能 ， 这 种 算法 在 
不 同 的 JVM 实 现 中 会 大 相 径 寿 。 如 有 果 程 序 依赖 于 终结 方法 被 执行 的 时 
间 点 ， 那 么 这 个 程序 的 行为 在 不 同 的 JVM 中 运行 的 表现 可 能 束 会 截然 
不 同 。 一 个 程序 在 你 测试 用 的 JVM 平 台 上 运行 得 非常 好 ， 而 在 你 最 重 
要 顾客 的 JVM 平 台 上 却 根本 无 法 运行 ， 这 是 完全 有 可 能 的 。 


延迟 终结 过 程 并 不 只 是 一 个 理论 问题 。 在 很 少见 的 情况 下 ， 为 类 提供 
终结 方法 ， 可 能 会 随意 地 延迟 其 实例 的 回收 过 程 。 一 位 同事 最 近 在 调 
试 一 个 长 期 运行 的 GUI 应 用 程序 的 时 候 ， 该 应 用 程序 莫名 其 妙 地 出 现 
outofMemoryerror 错误 而 死 摊 。 分 析 表 明 ， 该 应 用 程序 死 摊 的 时 候 ， 其 
终结 方法 队列 中 有 数 千 个 图 形 对 象 正 在 等 得 被 终结 和 回收 。 遗 憾 的 

征 ， 终 结 方法 线程 的 优先 级 比 该 应 用 程序 的 其 他 线程 要 低 得 多 ， 所 

以 ， 图 形 对 象 的 终结 速度 达 不 到 它们 进入 队列 的 速度 。Java 语 言 规范 
并 不 保证 哪个 线程 将 会 执行 终结 方法 ， 所 以 ， 除 了 不 使 用 终结 方法 之 
外 ， 并 没有 很 轻便 的 方法 能 够 避免 这 样 的 问题 。 


Java 语 言 规范 不 仅 不 保证 终结 方法 会 被 及 时 地 执行 ， 而 且 根本 就 不 保 
证 它们 会 被 执行 。 当 一 个 程序 终止 的 时 候 ， 某 些 已 经 无 法 访问 的 对 象 
上 的 终结 方法 却 根本 没有 被 执行 ， 这 是 完全 有 可 能 的 。 结 论 是 : 不 应 
GRE EHR BSAA ° 例如， 依赖 终结 方法 来 释放 
共享 资源 (比如 数据 库 ) 上 的 永久 锁 ， 很 容易 让 整个 分 布 式 系统 堵 
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不 要 被 System.gc 和 System.runFinalization 这 两 个 方法 所 诱惑 ， 它们 确 
实 增加 了 终结 方法 被 执行 的 机 会 ， 但 是 它们 并 不 保证 终结 方法 一 定 会 
被 执行 唯一 保证 终结 方法 被 执行 的 方法 是 System. runFinalizersOnExit 

) DRERZ ISA EE SLs Runtime. runFinalizersOnExit 。 这 两 个 方法 
都 有 致命 的 缺 隐 ， 已 经 被 废弃 了 [ThreadStop] ° 


当 你 并 不 确定 是 否 应 该 避免 使 用 终结 方法 的 时 候 ， 这 里 还 有 一 种 值得 
考虑 的 情形 : 如果 未 捕获 的 异常 在 终结 过 程 中 被 抛 出 来 ， 那 么 这 种 异 
常 可 以 被 忽略 ， 并 且 该 对 象 的 终结 过 程 也 会 被 终止 [JLS，12.6]。 未 捕 
获 的 异常 会 使 对 象 处 于 破坏 的 状态 (a corrupt state) ， 如 果 另 一 个 线 
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情况 下 ， 未 捕获 的 异常 将 会 使 线程 终止 ， 并 打印 出 栈 轨迹 (Stack 
Trace) , 但是， 如 采 异 常 发 生 在 终结 方法 之 中 ， 则 不 会 如 此 ， 甚 至 连 
警告 都 不 会 打印 出 来 。 


还 有 一 点 : MARADHI R ANY (Severe) fERETAK ° TE 
我 的 机 右上 ， 创 建 和 销毁 一 个 简单 对 象 的 时 间 大 约 为 5.6ns。 增 加 一 个 
终结 方法 使 时 间 增 加 到 了 2400ns。 换 句 话 说， 用 终结 方法 创建 和 销 叹 
对 象 慢 了 大 约 430 倍 。 


那么 ， 如 果 类 的 对 象 中 封装 的 资源 〈 例 如 文件 或 者 线程 ) 确实 需要 终 
止 ， 应 该 上 怎么 做 才能 不 用 编写 终结 方法 呢 ? 只 需 eA hin HA ee 
万 小 ， 并 要 求 该 类 的 客户 端 在 每 个 实例 不 再 有 用 的 时 候 调 用 这 个 方 
法 。 值 得 提 及 的 一 个 细节 和 是， 该 实例 必须 记录 下 目 己 是 否 已 经 被 终止 
T: 显 式 的 终止 方法 必须 在 一 个 私有 域 中 记录 下 “该 对 象 已 经 不 再 有 
效 ”。 如 果 这 些 方 法 古 在 对 象 已 经 终止 以 后 补 调 用 ， 其 他 的 方法 就 必须 


仿 查 这 个 域 ， 并 抛 出 IllegalStateException 异常 。 


显 式 终止 方法 的 典型 例子 是 InputStream `~ OutputStream 和 
java.sql.Connection 上 的 close 方法 a 另 一 个 例子 是 java.util.Timer ais 
的 cancel Tite: 它 执 行 必要 的 状态 改变 ， 使 得 与 Timer 实例 相关 联 
的 该 线程 温和 地 终止 自己 ° java.awt 中 的 例子 还 包括 Graphics .dispose 
和 Window.dispose ° 这 些 方 法 由 于 性 能 不 好 而 不 被 人 们 关注 S 一 个 相关 
的 方法 是 Image.flush ， 它 会 释放 所 有 与 mage 实例 相关 联 的 资源 ， 但 
是 该 实例 仍然 处 于 可 用 的 状态 ， 有 过 有 必要 的 话 ， 会 重新 分 配 资源 。 


赐 式 的 终 凡 万 该 请 家 与 try-finallyy ISR AMER EH, URRE 
外。 在 finally 子 句 内 部 调用 显 式 的 终止 方法 ， 可 以 保证 即使 在 使 用 对 
象 的 时 候 有 异常 抛 出 ， 该 终止 方法 也 会 执行 : 


// try-finally block guarantees execution of termination methods 
Foo foo = new Foo(...); 
try { 


// Do what must be done with foo 


} finally { 


foo.terminate(); // Explicit termination method 


那么 终结 方法 有 什么 好 处 呢 ? 它们 有 两 种 合法 用 途 。 第 一 种 用 途 是 ， 
当 对 象 的 所 有 者 和 起 记 调 用 前 面 段 落 中 建议 的 显 式 终止 方法 时 ， 终 结 方 
法 可 以 充当 “安全 网 (safety net) ”。 里 然 这 样 做 并 不 能 保证 终结 方法 
会 被 及 时 地 调用 ， 但 是 在 客户 端 无 法 通过 调用 显 式 的 终止 方法 来 正 稼 
结束 操作 的 情况 下 (希望 这 种 情形 尽 可 能 地 少 发 生 ) ， 迟 一 点 释放 关 
键 资源 总 比 永远 不 释放 要 好 。 但 是 MIRREN ER UGE AER 
LE, SURED PIOR-RES ， 因 为 这 表示 客户 端 代码 中 的 一 个 
Bug， 应 该 得 到 修复 。 如 采 你 正 考虑 编写 这 样 的 安全 网 终结 方法 ， 丈 
要 认真 考虑 清楚 ， 这 种 额外 的 保护 是 否 值得 你 付出 这 份额 外 的 代价 。 


显 式 终止 方法 模式 的 示例 中 所 示 的 四 各 类 ( Filernputstream 
FileOutputStream 、 Timer 和 Connection ) ; 都 具有 终结 方法 ， 当 它 们 
的 终止 方法 未 能 被 调用 的 情况 下 ， 这 些 终结 方法 充当 了 安全 网 。 


终结 方法 的 第 二 种 合理 用 途 与 对 象 的 AAT (native peer) 有 
关 。 本 地 对 等 体 是 一 个 本 地 对 象 (native object) ， 普 通 对 象 通过 本 地 
方法 (native method) 委托 给 一 个 本 地 对 象 。 因 为 本 地 对 等 体 不 是 一 
个 普通 对 象 ， 所 以 垃圾 回收 需 不 会 知道 它 ， 当 它 的 Java 对 等 体 被 回收 
的 时 候 ， 它 不 会 被 回收 。 在 本 地 对 等 体 并 不 拥有 关键 资源 的 前 提 下 ， 
终结 方法 正 是 执行 这 项 任务 最 合适 的 工具 。 如 有 果 本 地 对 等 体 拥有 必须 
补 及 时 终止 的 资源 ， 那 么 该 类 束 应 该 具有 一 个 显 式 的 终止 方法 ， 如 前 
所 述 。 终 止 方法 应 该 完成 所 有 必要 的 工作 以 便 释 放 关 键 的 资源 。 终 止 
方法 可 以 是 本 地 方法 ， 或 者 它 也 可 以 调用 本 地 方法 。 


值得 注意 的 很 重要 一 点 是 , “终结 方法 链 (finalizer chaining) ”并 不 会 
被 自动 执行 。 如 果 类 (SE oject ) BABAK, HAFRER SAB 
方法 ， 子 类 的 终结 方法 加 必须 手工 调用 超 类 的 终结 方法 。 你 应 该 在 一 
个 try 块 中 终结 子 类 ， 并 在 相应 的 finally 块 中 调用 超 类 的 终结 方法 。 这 
样 做 可 以 保证 ， 即 使 子 类 的 终结 过 程 抛 出 异常 ， 超 类 的 终结 方法 也 会 


得 到 执行 。 反 之 亦 然 。 代 码 示例 如 下 。 注 意 这 个 示例 使 用 了 override 
注解 ( @override ) ， 这 是 Java 1.5 发 新 版 本 将 它 增 加 到 Java 平 台中 
的 。 你 现在 可 以 不 管 override 注解 ， 或 者 到 第 36 条 查阅 一 下 它们 表示 


什么 意思 : 


// Manual finalizer chaining 


@Override protected void finalize () throws Throwable { 


try Pi{ 


. // Finalize subclass state 


finally Ei 


super .finalize(); 


如 果子 类 实现 者 有 覆盖 了 超 类 的 终结 方法 ， 但 是 忘 了 手工 调用 超 类 的 终 
结 方 法 (或 者 有 意 选 择 不 调用 超 类 的 终结 方法 ) ， 那 么 超 类 的 终结 方 
法 将 永远 也 不 会 被 调用 到 。 要 防范 这 样 粗 心 大 意 或 者 恶意 的 子 类 是 有 
可 能 的 ， 代 价 就 是 为 每 个 将 要 终 被 的 对 象 创建 一 个 附加 的 对 象 。 不 是 
把 终结 方法 放 在 要 求 终结 处 理 的 类 中 ， 而 是 把 终结 方法 放 在 一 个 匿名 
的 类 〈 见 第 22 条 ) 中 ， 该 匿名 类 的 唯一 作用 就 是 终结 它 的 外 围 实 例 

(enclosing instance) 。 该 匿名 类 的 单个 实例 被 称 为 BATES LA 

(finalizer guardian) ， 外 围 类 的 每 个 实例 都 会 创建 这 样 一 个 守卫 者 。 
外 围 实例 在 它 的 私有 实例 域 中 保存 着 一 个 对 其 终结 方法 守卫 者 的 唯一 
引用 ， 因 此 终结 方法 守卫 者 与 外 围 实例 可 以 同时 启动 终结 过 程 。 当 和 守 
卫 者 被 终结 的 时 候 ， 它 执行 外 围 实例 所 期 望 的 终结 行为 ， 束 好 像 它 的 
终结 方法 是 外 围 对 象 上 的 一 个 方法 一 样 : 


// Finalizer Guardian idiom 


public class Foo { 


// Sole purpose of this object is to finalize outer Foo object 
pricate final Object finalizerGuardian = new Object() { 
@Override protected void Finalize () throws Throwable { 
eames! / / F ute c ect 
i 
}; 
/ mai nitt 


注意 ， 公 有 类 ro 并 没有 终结 方法 (除了 它 从 oject 中 继承 了 一 个 
无 关 紧 要 的 之 外 ) ， 所 以 子 类 的 终结 方法 是 否 调用 super .finalize 并 不 
重要 。 对 于 每 一 个 带 有 终结 方法 的 非 tin 公有 类 ， 都 应 该 考虑 使 用 
这 种 方法 。 


总 之 ， 除 非 是 作为 安全 网 ， 或 者 是 为 了 终止 非 关 键 的 本 地 资源 ， 否 则 
请 不 要 使 用 终结 方法 。 在 这 些 很 少见 的 情况 下 ， 既 然 使 用 了 终结 

法 ， 就 要 记 住 调用 super.finalize 。 如 果 终 结 方法 作为 安全 网 ， 要 沁 得 
记录 终结 方法 的 非法 用 法 。 。 最后， 如 果 需 要 把 终结 方法 与 公有 的 非 
final 类 关联 起 来 ， 请 考虑 使 用 终结 方法 守卫 者 ， 以 确保 即使 子 类 的 
终结 方法 未 能 调用 super.finalize ， 该 终结 方法 也 会 被 执行 。 


第 三 章 对 于 所 有 对 象 都 通用 的 方法 


尽管 opject 是 一 个 具体 类 ， 但 是 设计 它 主 要 是 为 了 扩展 。 它 所 有 的 非 
final FE ( equals ` hashCode `~ toString `~ clone 和 finalize ) 

都 有 明确 的 WAIE (general contract) ， 因 为 它们 被 设计 成 是 要 被 
fait (override) 的 。 任 何 一 个 类 ， 它 在 人 覆盖 这 些 方 法 的 时 候 ， 都 有 责 


Fe EAE; MRR MEA — A, RT A ERY 
类 (例如 Hashwap 和 Hasnset ) 就 无 法 结合 该 类 一 起 正常 运作 。 


本 章 将 讲述 何 时 以 及 如 何 覆 盖 这 些 非 fina 的 object DIS ° REN 
再 讨论 finalize 方法 ， 因为 第 7 条 已 经 讨论 过 这 个 方法 了 而 
Comparable.compareTo 虽然 不 是 Object 的 方法 ， 但 是 本 章 也 对 它 进 行 讨 
论 ， 因 为 它 具 有 类 似 的 特征 。 


第 8 条 : FBR equals 时 请 遵守 通用 约 


定 


fit equals 方法 看 起 来 很 简单 ， 但 是 有 许多 履 凑 方式 会 导致 错误 ， 并 
HARER Ho RAT ERIS ALIA EAN equals 方 
法 ， 在 这 种 情况 下 ， 类 的 每 个 实例 都 只 与 它 目 身 相 等 。 如 果 满 足 了 以 
下 任何 一 个 条 件 ， 这 吏 正 是 所 期 望 的 结果 : 


。 类 的 每 个 实例 本 质 上 都 是 唯一 的 。 对 于 代表 活动 实体 而 不 是 值 


(value) 的 类 来 说 确实 如 此 。 例 如 Thread ° Object 提供 的 
equals 实现 对 于 这 些 类 来 说 正 是 正确 的 行为 。 
不 关心 类 是 否 提供 了 “逻辑 相等 (logical equality) ”的 测试 功能 

o 例如 ， java.util.Random 覆盖 了 equals , 以 检查 两 个 Random 实 
例 是 否 产生 相同 的 随机 数 序 列 ， 但 是 设计 者 并 不 认为 客户 端 需要 
或 者 期 望 这 样 的 功能 。 在 这 样 的 情况 下 ， 从 object 继承 得 到 的 
equals 实现 已 经 足够 了 ° 
HRCA m] equas ， 从 超 类 继承 过 来 的 的 行为 对 于 子 类 也 是 
合适 的 。 例 如 ， 大 多 数 的 see 实现 都 从 _ Abstractset 继承 equals 
实现 ， List 实现 从 AbstractList 继承 equals 实现 ， Map 实现 从 
AbstractMap 继承 equals 实现 。 
类 是 私有 的 或 是 包 级 私有 的 ， 可 以 确定 它 的 equas 方法 永远 也 不 
会 被 调用 。 在 这 种 情况 下 ， 无 疑 是 应 该 覆盖 equas 方法 的 ， 以 
防 它 被 意外 调用 : 


@Override public boolean equals (Object o) { 


throw new AssertionError(); // Method is never called 


那么 ， 什 么 时 候 应 该 覆盖 object.equais WE? WRAAAA CHAINS 
辑 相等 "概念 不同 于 对 象 等 同 的 概念 ) ， 而 且 超 类 还 没有 和 履 盖 

equals 以 实现 期 望 的 行为 ， 这 时 我 们 就 需要 覆盖 equals 方法 。 这 通 
常 属于 “ 值 类 (value class) ”的 情形 。 值 类 仅仅 是 一 个 表示 值 的 类 ， 例 


如 integer 或 者 pate 。 程 序 员 在 利用 equas 方法 来 比较 值 对 象 的 引 
用 时 ， 和 希望 知道 它们 在 逻 钳 上 证 否 相 等 ， 而 不 是 想 了 解 它 们 和 是否 指 问 
同一 个 对 象 。 为 了 满足 程序 员 的 要 求 ， 不 仪 必需 窗 盖 equals 方法 ， 而 
且 这 样 做 也 使 得 这 个 类 的 实例 可 以 被 用 作 映 射 表 (map) 的 键 

(key) ， 或 者 集合 (set) 的 元 素 ， 使 映射 或 者 集合 表现 出 预期 的 行 


a} 
y 


有 一 种 “ 值 类 ”不 需要 和 窗 盖 equals 方法 ， 即 用 实例 受 控 〈 见 第 1 条 ) M 
保 “ 每 个 值 至 多 只 存在 一 个 对 象 ” 的 类 。 枚 举 类 型 ( 见 第 30 条 ) 就 属于 
这 种 类 。 对 于 这 样 的 类 而 言 ， 逻 辑 相 同 与 对 象 等 同 是 一 回 事 ， 因 此 
Object 的 equals FES Fie EH equals 方法 。 


E equals 方法 的 时 候 ， 你 必须 要 遵守 它 的 通用 约定 。 下 面 是 约定 
HNZ, XB object 的 规范 [JavaSE6]: 


equals 方法 实现 了 MMAR (equivalence relation) : 


。 自 反 性 (reflexive) 。 对 于 任何 非 nun 的 引用 值 x, 
x.equals(x) 必须 返回 true © 

。 对称 性 (symmetric) 。 对 于 任何 非 ma 的 引用 值 x Aly ， 

2 H4 y.equals(x) VX [Al true 时 , x.equals(y) 必须 返回 true 


。 传 递 性 (transitive) 。 对 于 任何 非 nu 的 引用 值 x > y 和 
z o 如果 x.equals(y) 返回 true , Ff A y.equals(z) 也 退回 true 
那么 x.equals(z) 也 必须 返回 true ° 

。 一 致 性 (consistent) 。 对 于 任何 非 nu 的 引用 值 x 和 y ， 
只 要 equalis 的 比较 操作 在 对 象 中 所 用 的 信息 没有 被 修改 ， 多 次 调 
用 x.equals(x) We — SCH i E] true , 或 者 一 致 的 返回 false 

e 对 于 任何 非 null 的 引用 值 z. x.equals (null) 必须 返回 false 


BRAP RIT EAA Re BWR, AUNT EWE E ER BY BEA LEA eR oak 
惧 ， 但 是 绝对 不 要 忽视 这 些 规 定 ! 如 果 你 违反 了 它们 ， 就 会 发 现 你 的 
程序 将 会 表现 不 正常 ， 甚 至 骨 演 ， 而 且 很 难 找到 失败 的 根源 。 用 John 
Donne 的 话说 ， 没 有 哪个 类 是 孤立 的 。 一 个 类 的 实例 通 肖 会 被 频 粽 地 
传递 给 男 一 个 类 的 实例 。 有 许多 类 ， 包 括 所 有 的 集合 类 (collection 
class) 在 内 ， 都 依赖 于 传递 给 它们 的 对 象 是 否 遵守 了 equas 约定 。 


现在 你 已 经 知道 了 违反 equas 约定 有 多 么 可 怕 ， 现 在 我 们 就 来 更 细致 
地 讨论 这 些 约 定 。 值 得 欣慰 的 是 ， 这 些 约定 虽然 看 起 来 很 下 人， 实际 
上 并 不 十 分 复杂 。 一 旦 理解 了 这 些 约定 ， 要 遵守 它们 并 不 困难 。 现 在 
我 们 按照 顺序 逐一 查看 以 下 5 个 要 求 : 

自 反 性 (reflexive) 一 一 一 一 第 一 个 要 求 仅仅 说 明 对 象 必须 等 于 其 自 
号 。 很 难 想象 会 无 意识 地 违反 这 一 条 。 加 入 违背 了 这 一 条 ， 然 后 把 该 
类 的 实例 添加 到 集合 (collection) 中 ， 该 集合 和 contains 方法 将 果断 
的 告诉 你 ， 该 集合 不 包含 你 刚刚 添加 的 实例 。 

对 称 性 (symmetric) 一 第 二 个 要 求 是 说 ， 任 何 两 个 对 象 对 
于 “它们 是 否 相等 ?的 问题 都 必须 保持 一 致 。 与 第 一 个 要 求 不 同 ， 大 无 
意 中 违 反 这 一 条 ， 这 种 情形 倒是 不 难 想象 。 例 如 ， 考 虑 下 面 的 类 ， 它 
实现 了 一 个 区 分 大 小 写 的 字符 串 。 字 符 串 由 tostring 保存 ， 但 在 比较 
操作 中 被 忽略 。 


// Broken - violate symmetry 
public final class CaseInsensitiveString { 


private final String s; 


public CaseInsensitiveString (String s) { 
if (s == null ) 
throw new NullPointerException(); 


this fsi- S; 


// Broken - violate symmetry! 


@Override public boolean equals (Object o) { 
if (o instanceof CaseInsensitiveString) 
return s.equalsIgnoreCase( 
((CaseInsensitiveString) 0).Ss); 
if (o instanceof String) // One-way interoperability! 
return s.equalsIgnoreCase((String) o); 


return false ; 


// Remainder omitted 


在 这 个 类 中 ， as 方法 的 意图 非常 好 ， 它 企图 与 普通 的 字符 串 ( 
string ) 对 象 进行 互 操作 。 假 设 我 们 有 一 个 不 区 分 大 小 写 的 字符 串 和 
一 个 普通 的 字符 囊 ， 


CaseInsensitiveString cis = new CaseInsensitiveString( "Polish" ); 


String s = "polish" ; 


正如 所 料 ， cis.equals(s) 返回 true ° 问题 在 于 ， 虽然 
CaseInsensitiveString 类 中 的 equals 方法 知道 普通 的 字符 串 ( String ) 对 
象 ， 但 是 ， string 类 中 的 equals 方法 却 并 不 知道 不 区 分 大 小 写 的 字 
符 串 因此 ， s.equals(cis) 退回 false , 显然 违反 了 对 称 性 假设 你 
把 不 区 分 大 小 写 的 字符 串 对 象 放 到 一 个 集合 


List<CaseInsensitiveString> list = new ArrayList<CaseInsensitiveString>(); 


list.add(cis); 


此 时 list.contains(s) 会 返回 什么 结果 呢 ? 没 人 知道 ， 在 Sun 的 当前 实 
现 中 ， 它 碰巧 返回 tase ， 但 这 只 是 这 个 特定 实现 得 出 的 结果 而 已 。 
在 其 他 的 实现 中 ， 它 有 可 能 返回 true , 或 者 抛 出 一 | 运行 时 
(runtime) 异常 。 AEK J equals AVE, SHA MWXIR ANT ADT 
BL, UR FEL A AMIS EDT RATAN RIX fF 。 


为 了 解决 这 个 问题 ， 只 需 把 企图 与 string 互 操作 的 这 段 代码 从 
equals 方法 中 去 挥 整 可 以 了 。 这 样 做 之 后 ， 束 可 以 重 构 该 方法 ,使 它 
变 成 一 条 单独 的 返回 语句 : 


@Override public boolean equals (Object o) { 
return o instanceof CaseInsensitiveString && 


((CaseInsensitiveString) 0).s.equalsIgnoreCase(s); 


传递 性 (transitivity) 一 -一 equas 约定 的 第 三 个 要 求 是 ， 如 果 一 
个 对 象 等 于 第 二 个 对 象 ， 并 且 第 二 个 对 象 又 等 于 第 三 个 对 象 ， 则 第 一 
个 对 象 一 定 等 于 第 三 个 对 象 。 同 样 地 ， 无 意识 地 违反 这 条 规则 的 情形 
也 不 难 想象 。 考 虑 子 类 的 情形 ， 它 将 一 个 新 的 值 组 件 (value 
component) 添加 到 了 超 类 中 。 换 名 话说 ， 子 类 增加 的 信息 会 影响 到 
equals 的 比较 结果 。 我 们 首先 以 一 个 简单 的 不 可 变 的 二 维 整数 型 

Point 类 作为 开始 : 


public class Point { 
private final int Be 


private final int y; 


public Point ( int x, int y) { 


this. X = x; 


this .y = y; 


@Override public boolean equals (Object o) { 
if (!(0 instanceof Point)) 
return false ; 
Point p = (Point)o; 


return p.x == x && p.y == y; 


// Remainder omitted 


假设 你 想 要 扩展 这 个 类 ， 为 一 个 点 添加 颜色 信息 : 
public class ColorPoint extends Point { 


private final Color color; 


public ColorPoint ( int x, int y, Color color) { 


super (x, y); 


this .color = color; 


// Remainder omitted 


equals TEREA 如 采 完 全 不 提供 equas 方法 ， 而 是 直接 从 
point 继承 过 来 ， 在 equals MTC BCH IRE fs EOC Pa T e R 
然 这 样 做 不 会 违反 equais 约定 ， 但 是 很 明显 是 无 法 接受 的 。 假 设 你 纺 
写 了 一 个 equas 方法 ， 只 有 当 它 的 参数 是 另 一 个 有 色 点 ， 并 且 具 有 同 
样 的 位 置 和 颜色 时 ， 它 才 会 返回 true 


// Broken - violates symmetry! 
@Override public boolean equals (Object o) { 
if (!(0 instanceof ColorPoint) ) 
return false ; 


return super .equals(o) && ((ColorPoint) o).color == color; 


这 个 方法 的 问题 在 于 ， 你 在 比较 普通 点 和 有 色 点 ， 以 及 相反 的 情形 
时 ， 可 能 会 得 到 不 同 的 结果 。 前 一 种 比较 忽略 了 颜色 信息 ， 而 后 一 种 


比较 则 忆 古 返回 raise. LADEN RAYNER -J EULA LEAT 
题 所 在 ， 我 们 创建 一 个 普通 点 和 一 个 有 色 点 : 


Point p = new Point( 1, 2 ); 


ColorPoint cp = new ColorPoint( 1, 2 , Color.RED); 


然后 ， p.equals(cp) 返回 true , cp.equals(p) 返回 false 。 你 可 以 做 
这 样 的 尝试 来 修正 这 个 问 Z, IE ColorPoint.equals 在 进行 “混合 比较 ”日生 
忽略 颜色 信息 JOY = 


// Broken - violates transitivity! 
@Override public boolean equals (Object o) { 
if (!(o0 instanceof Point)) 


return false ; 


// If o is normal Point, do a color-blind comparison 


if (!(0 instanceof ColorPoint) ) 


return o.equals( this ); 


// 0 is a ColorPoint; do a full comparison 


return super .equals(o) && ((ColorPoint) o).color == color; 


这 种 方法 确实 提供 了 对 称 性 ， 但 十 却 牺 牲 了 传递 性 


ColorPoint p1 = new ColorPoint( 1, 2 , Color.RED); 
Point p2 = new Point( 1, 2 ); 


ColorPoint p3 = new ColorPoint( 1, 2 , Color.Blue); 


此 时 ， p1.equals(p2) 和 p2.equals(p3) 都 返回 enug 3 但 是 p1.equals(p3) 
则 返回 false， 很 显然 违反 了 传递 性 。 前 两 种 比较 不 考虑 颜色 信息 (“ 色 
B”) ， 而 第 三 种 比较 则 考虑 了 颜色 信息 。 


LARUE? 事实 上 ， 这 古 面 同 对 和 象 语言 中 关于 等 价 天 系 的 一 个 基本 
问题 。 我 们 AA ED ET LAMA AAT, BERIDA, I 
~ equals 约定 GRAFH A R AR THAR PT RAIL 


你 可 能 听 说 ， 在 equals 方法 中 用 getClass 测试 代替 instanceof 测 
试 ， 可 以 扩展 可 实例 化 的 类 和 增加 新 的 值 组 件 ， 同 时 保留 equals 约 
KE: 


// Broken - violates Liskov substitution principle (page 40) 
@Override public boolean equals (Object o) { 
if (o == null || o.getClass() !== getClass()) 
return false ; 
Point p = (Point) 0; 


return p.xX == X && p.y == y; 


这 段 程序 只 有 当 对 象 具 有 相同 的 实现 时 ， 才 能 使 对 象 等 同 。 虽 然 这 样 
也 不 算 太 糟糕 ， 但 是 结果 却 是 无 法 接受 的 。 


假设 我 们 要 编写 一 个 方法 ， 以 检验 某 个 整数 点 是 否 处 在 单位 圆 中 。 下 
面 是 可 以 采用 的 其 中 一 种 方法 : 


// Initialize UnitCircle to contain all Points on the unit circle 


Private static final Set<Point> unitCircle; 


static { 


unitCircle = new HashSet<Point>(); 


unitCircle.add( new Point( i, 0 )); 


unitCircle.add( new Point( 9, 1 )); 


unitCircle.add( new Point(- 1, 0 )); 


unitCircle.add( new Point( 9, - 1 )); 


public static boolean onUnitCircle (Point p) { 


return unitCircle.contains(p); 


虽然 这 可 能 不 是 实现 这 种 功能 的 最 快 方式 ， 不 过 它 的 效果 很 好 。 但 是 
假设 你 通过 某 种 不 添加 值 组 件 的 方式 扩展 了 point ， 例 如 让 它 的 构造 
am OR OWE SAB SSE: 


public class CounterPoint extends Point { 


private static final AtomicInteger counter = new AtomicInteger(); 


public CounterPoint ( int x, int y) { 
super (x, y); 


counter .incrementAndGet(); 


} 


public int numberCreated () { return counter.get(); } 


AREA ( Liskov subsititution) 认为 ， 一 个 类 型 的 任何 重要 属 
性 也 将 适用 于 它 的 子 类 型 ， 因 此 为 该 类 型 编写 的 任何 方法 ， 在 它 的 子 
类 型 上 也 应 该 同样 运行 地 很 好 [Liskov87]。 但 是 假设 我 们 将 

CounterPoint 实例 传 给 了 onUnitCircle 方法 如 果 Point 类 使 用 了 基于 
getClass 的 equals eee 无 论 CounterPoint 实例 的 X 和 y 值 是 什 
么 ， onUnitCircle 方法 都 会 返回 false ° 之 所 以 如 此 ， 是 因为 像 
onUnitCircle 方法 所 用 的 HashSet 这 样 的 集合 ， | 用 equals 方法 检验 
包含 条 件 ， 没有 任何 CounterPoint 实例 与 任何 Point 对 应 但 是 : 如 
果 在 Point 上 使 用 适当 的 基于 instanceof 的 equals a, Bisel 
CounterPoint ET, 相同 的 onUnitCircle 方法 就 会 工作 得 很 好 j 


虽然 没有 一 种 令 人 满意 的 办 法 可 以 既 扩 展 不 可 实例 化 的 类 ， 又 增加 值 
组 件 ， 但 还 是 有 一 种 不 错 的 权宜 之 计 (workaround) 。 根 据 第 16 条 的 
建议 : 复合 优先 于 继承 。 我 们 不 再 让 CounterPoint 扩展 Point , 而 是 
在 CounterPoint 中 加 入 一 个 私有 的 Point 域 ， 以 及 一 个 公有 的 RAL 
(view) 方法 ( 见 第 5 条 ) ， 此 方法 返回 一 个 与 该 有 色 点 处 在 相同 位 置 
的 普通 Point WE: 


// Adds a value component without violating the equals contract 


public class ColorPoint { 


private final Point point; 


private final Color color; 


public ColorPoint ( int x, int y, Color color) 


if (color == null ) 


throw new NullPointerException(); 


point = new Point(x, y); 


this .color = color; 


J ** 


* Returns the point-view of this color point. 


$7 


pulic Point asPoint () { 


return point; 


@Override public boolean equals (Object o) { 


if (!(0 instanceof ColorPoint) ) 
return false ; 
ColorPoint cp = (ColorPoint) o; 


return cp.point.equals(point) && cp.color.equals(color); 


在 Java 平 台 类 库 中 ， 有 一 些 类 扩展 了 可 实例 化 的 类 ， 并 添加 了 新 的 值 
组 件 。 例如 ， java.sql.Timestamp 对 java.util.Date 进行 了 扩展 ， 并 增加 
了 了 nanoseconds tak o Timestamp 的 equals 实现 确实 违反 了 对 称 性 ， 如 果 
Timestamp 和 pate 对 象 被 用 于 同一 个 集合 中 或 者 以 其 他 方式 被 混合 在 
一 起 ， 则 会 引起 不 正确 的 行为 。 timestam 类 有 一 个 免责 声明 ， 告 诚 
程序 员 不 要 混合 使 用 vate F Tinestamp 对 象 。 只 要 你 不 把 它们 混合 在 
一 起 ， 束 不 会 有 拼 烦 。 除 此 之 外 没有 其 他 的 措施 可 以 防止 你 这 么 做 ， 
而 且 结 末 导致 的 错误 将 很 难 调试 。 timestamp 类 的 这 种 行为 是 个 错 
误 ， 不 值得 效仿 。 


注意 ， 你 可 以 在 一 个 FAR (abstract) 类 的 子 类 中 增加 新 的 值 组 件 ， 
而 不 会 违反 equals 预定 。 对 于 根据 第 20 条 的 建议 “用 类 层次 (class 
hierarchies) 代 蔡 标签 类 (tagged class) ”而 得 到 的 那 种 类 层次 结构 来 
说 ， 这 一 点 非常 重要 。 例 如 ， 你 可 能 有 一 个 抽象 的 shape R, ERA 
任何 值 组 件 ， Circle 子 类 添加 了 一 个 radius 域 ， Rectangle 子 类 添 
加 了 iength 和 width 域 。 只 要 不 可 能 直接 创建 超 类 的 实例 ， 前 面 所 
述 的 种 种 问题 融 都 不 会 发 生 。 


一 致 性 (consistency) equals 约定 的 第 四 个 要 求 是 ， 如 果 
两 个 对 象 相等 ， 它 们 束 必 须 始 终 保 持 相 等 ， 除 非 它们 中 有 一 个 对 和 象 


(或 者 两 个 都 ) 被 修改 了 。 换 句 话 说， 可 变 对 象 在 不 同 的 时 候 可 以 与 
不 同 的 对 象 相等 ， 而 不 可 变 对 象 则 不 会 这 样 。 当 你 在 写 一 个 类 的 时 
候 ， 应 该 仔细 考虑 她 是 否 应 该 是 不 可 变 的 〈 见 第 15 条 ) 。 如 果 认为 它 
应 该 是 不 可 变 的 ， 就 必须 保证 equals 方法 满足 这 样 的 限制 条 件 : 相等 
的 对 象 永远 相等 ， 不 相等 的 对 象 永远 不 相等 。 


无 论 是 否 是 不 可 变 的 ， WNAE equals TILA AH SEN RAUR 。 
如 果 违 反 了 这 条 从 令 ， 要 想 满 足 一 致 性 的 和 要求 就 十 分 困难 了 。 例 如 ， 
java.net.URL 的 equals 方法 依赖 于 对 URL 中 主机 IP 地 址 的 比较 ° 将 一 
个 主机 名 转变 成 IP 地 址 可 能 需要 访问 网 络 ， 随 着 时 间 的 推移 ， 不 确保 
会 产生 相同 的 结果 。 这 术 会 导致 UREL 的 equals 方法 违反 equals Ay 
定 ， 在 实践 中 可 能 引发 一 些 问题 。 (遗憾 的 是 ， 因 为 兼容 性 的 要 求 ， 
这 一 行为 无 法 被 改变 。) 除了 极 少数 的 例外 情况 ， equals 方法 都 应 该 
对 往 留 在 内 存 中 的 对 象 执行 确定 性 的 计算 。 


非 空 性 (Non-nullity) 最 后 一 个 要 求 没 有 名 称 ， 我 姑且 
cheng'ta'wei 称 它 为 “ 非 空 行 (Non-nullity) ”， 和 意思 是 指 所 有 的 对 象 都 必 
须 不 等 于 nur 。 尽 管 很 难 想象 什么 情况 下 .equals(null) 调用 会 意外 
地 返回 true , 但 是 意外 抛 出 NullPointerException 异常 的 情形 却 不 难 想 
Ge 通用 约定 不 允许 抛 出 NullPointerException 异 津 2 许多 类 的 equals 
方法 都 通过 显示 的 ma 测试 来 防止 这 种 情况 : 


@Override public boolean equals (Object o) { 
if (o == null ) 


return false ; 


这 项 测试 是 不 必要 的 。 为 了 测试 其 参数 的 等 同性 。 equas 方法 必须 先 
把 参数 转换 成 适当 的 类 型 ， 以 便 可 以 调用 它 的 访问 方法 (accessor) ， 
或 者 访问 它 的 域 。 在 进行 转换 之 前 ， equals 方法 必须 使 用 instanceof 
操作 符 ， 检 查 其 参数 是 否 为 正确 的 类 型 


@Override public boolean equals (Object o) { 
if (!(0 instaceof MyType) ) 
return false ; 


MyType mt = (MyType) o; 


如 采 漏 掉 了 这 一 步 的 类 型 检查 ， 并 且 传 递 给 equas 方法 的 参数 有 事 错 
误 的 类 型 ， 那么 equals 方法 将 会 抛 出 ClassCastException ae 这 就 违 
Rs equals 的 约定 “但 是 ， 如 果 instanceof 的 第 一 个 操作 数 为 null 

， 那 么 ， 不 管 第 二 个 操作 数 是 哪 种 类 型 ， instanceof 操作 符 都 会 指定 
应 该 返回 false [JLS, 15.20.2] 2 因此 ， 如 果 把 null 传递 给 equals 
WE, 类 型 检查 就 会 返回 false , 所 以 不 需要 单独 的 null 检查 。 


结合 所 有 这 些 要 求 ， 得 出 了 以 下 实现 高 质量 equas 方法 的 诀 穷 : 


1. ”使 用 - 操作 符 检查 “参数 是 否 为 这 个 对 象 的 引用 ”。 如 
果 是 ， 则 返回 true 。 这 只 不 过 是 一 种 性 能 优化 ， 如 采 
比较 操作 有 可 能 很 兄 贯 ， 束 值得 这 么 做 。 


2. 使 用 instanceof 操作 符 检查 “参数 是 否 为 正确 的 类 型 ”。 
如 果 不 是 ， 则 返回 tase 。 一 般 说 来 ， 所 谓 “ 正 确 的 类 
型 ”是 指 equals 方法 所 在 的 那个 类 。 有 些 情况 下 ， 是 指 
该 类 所 实现 的 某 个 接口 。 如 果 类 实现 的 接口 改进 了 
equals 约定 ， 人 允许 在 实现 了 该 接口 的 类 之 间 进 行 比较 ， 
那么 就 使 用 接口 。 集 合 接口 (collection interface) 如 
Set ~ List `~ Map 和 Map .Entry 具有 这 样 的 特性 ? 


3. ”把 参数 转换 成 正确 的 类 型 。 因 为 转换 之 前 进行 过 
instanceof 测试 ， 所 以 确保 会 成 功 o 


对 于 该 类 中 每 个 “关键 (significant) 域 ， 检 查 参 数 中 的 
域 是 否 与 该 对 象 中 对 应 的 域 相 匹配 ” 。 如 果 这 些 测试 全 
部 成 功 ， 则 返回 true ; 否则 返回 tase 。 如 采 第 2 步 中 
的 类 型 是 个 借口 ， 殊 必须 通过 接口 方法 访问 参数 中 的 
域 ， 如 采 该 类 型 是 个 类 ， 也 许 束 能 够 直接 访问 参数 中 的 
域 ， 这 要 取决 于 它们 的 可 访问 性 。 


对 于 既 不 是 fioat 也 不 是 doue 类 型 的 基本 类 型 域 ， 
可 以 使 用 == 操作 符 进 行 比较 ; 对 于 对 象 引用 域 ， 可 以 
递归 地 调用 equais 方法 ; 对 于 float 域 ， 可 以 使 用 
Float ,compare 方法 ; 对 于 double tak , 则 使 用 
Double.compare 。 对 于 float 和 double 域 进 行 特殊 的 处 
理 是 有 必要 的 ， 因 为 存在 着 Float.Nanw ` -e.ef 以 及 类 
似 的 double 和 常量; 详细 信息 请 参考 Float.equals 的 文 
档 。 对 于 数组 域 ， 则 要 把 以 上 这 些 指导 原则 应 用 到 每 个 
TRE ° 如果 数 组 域 中 的 每 个 元 素 都 很 重要 ， 束 可 以 使 
用 发 行 版 本 1.5 中 新 增 的 其 中 一 个 arrays.equals 方法 。 


有 些 对 象 引用 域 包 台 nu 可 能 是 合法 的 ， 所 以 ， 为 了 
避免 可 能 导致 Nul1lPointerException FH, 则 使 用 下 面 的 习 
惯用 法 来 比较 这 样 的 域 : 


(field == null ? o.field == null : field.equals(o.field)) 


如 果 field 域 和 ofiera 通 癌 是 相同 的 对 象 引 用 ， 那 么 
下 面 的 做 法 束 会 更 快 一 些 : 


(field == o.field || (field != null 
&& field.equals(o.field) )) 


对 于 有 些 类 ， 比如 前 面 提 到 的 CaseInsensitiveString ZR 
域 的 比较 要 比 简单 的 等 同性 测试 复杂 的 多 。 如 有 果 是 这 种 
情况 ， 可 能 会 希望 保存 该 域 的 一 个 "范式 (canonical 

form) ”， 这 样 equas 方法 就 可 以 根据 这 些 范 式 进行 低 
开销 的 精确 比较 ， 而 不 是 高 开销 的 非 精 确 比较 。 这 种 方 


法 对 于 不 可 变 类 ( 见 第 15 条 ) 是 最 为 合适 的 ; 如 采 对 象 
可 能 发 生变 化 ， 束 必须 使 其 范式 保持 最 新 。 


域 的 比较 顺序 可 能 会 影响 到 equas 方法 的 性 能 。 为 了 获 
得 最 佳 的 性 能 ， 应 该 罪行 比较 最 有 可 能 不 一 致 的 域 ， 或 
者 是 开销 最 低 的 域 ， 最 理想 的 情况 是 两 个 条 件 同时 满足 
的 域 。 你 不 应 该 去 比较 那些 不 属于 对 象 逻辑 状态 的 域 ， 
例如 用 于 同步 操作 的 Lock 域 。 也 不 需要 比较 见 余 域 

(redundant field) ， 因 为 这 些 见 余 域 可 以 由 “关键 域 ” 计 
算 获 得 ， 但 是 这 样 做 有 可 能 提高 equals 方法 性 能 。 如 果 
TUR TED RN SRA alt, Ee Ree Mia ay bh 
省 当 比 较 失 败 时 去 比较 实际 数据 所 需要 的 开销 。 例 如 ， 
假设 有 一 个 polygon 类 ， 并 缓存 了 该 区 域 。 如 果 两 个 多 
VAEN Xt, WA VRE MEEI ARAME 
高 点 。 


当 你 编写 完成 了 equas 方法 之 后 ， 应 该 问 目 己 三 个 问 

题 ， 它 是 不 是 对 称 的、 传递 的 、 一 致 的 ? 并 且 不 要 只 是 
目 问 ， 还 要 编写 单元 测试 来 检验 这 些 特性 ! WR ASR 
REN, BORLA, HMHI equals 方法 的 代 
码 。 当 然 ， equals 方法 也 必须 满足 其 他 两 个 特性 (A 
性 和 非 空 性 ) ， 但 是 这 两 种 特性 通常 会 自动 满足 。 


根据 上 面 的 记 守 构建 的 equas 方法 的 具体 例子 ， 请 参看 第 9 条 的 


PhoneNumber.equals ° 下 面 是 最 后 的 - 些 E: 


覆盖 equals 时 总 要 覆盖 hashcode ( 见 第 9 条 ) 3 


不 要 企图 让 equals 方法 过 于 智能 k 如 果 只 是 简单 地 测 

试 域 中 的 值 是 否 相 等 ， 则 不 难 做 到 遵守 equals 约定 。 如 
果 想 过 度 地 去 寻求 各 种 等 价 天 系 ， 则 很 容易 陷入 麻烦 之 
中 。 把 任何 一 种 别名 形式 考虑 到 等 价 的 范围 内 ， 往 往 不 
会 是 个 好 主意 。 例 如 ， rie 类 不 应 该 视图 把 指向 同一 

个 文件 的 符号 链接 (symbolic link) 当 作 相等 的 对 象 来 看 
f° ATSE File 类 没有 这 样 做 。 


不 要 将 equals 声明 中 的 Object 对 象 替换 为 其 他 的 类 型 
o 程序 员 编 写 出 下 面 这 样 的 equals 方法 并 不 鲜 见 ， 这 会 


i 上 数 个 小 时 部 所 不 清 为 什么 它 不 能 正常 工 


public boolean equals (MyClass 0) { 


问题 在 于 ， 这 个 方法 并 没有 和 窗 放 object.equals , ANE 
的 参数 应 该 是 oject 类 型 ， 相 反 ， 它 重 载 (overload) 
T Object.equals ( 见 第 41 条 ) 。 在 原 有 equals 方法 的 基 
础 上 ， 再 提供 一 个 “ 强 类 型 (strongly typed) "H9 equals 
方法 ， 只 要 这 两 个 方法 返回 同样 的 结果 (没有 强制 的 理 
由 必须 这 样 做 ) ， 那 么 这 就 是 可 以 接受 的 。 在 某 些 特定 
的 情况 下 ， 它 也 许 能 够 稍微 改善 性 能 ， 但 是 与 增加 的 复 
杂 性 相 比 ， 这 种 做 法 是 不 值得 的 〈 见 第 55 条 ) 


@override 注解 的 用 法 一 致 ， 就 如 本 条 目 所 示 ， 可 以 防止 
犯 这 种 错误 ( 见 第 36 条 ) 。 这 个 equals 方法 不 能 编译 ， 
错误 消息 会 告诉 你 到 底 哪 里 出 了 问题 : 


@Override public boolean equals (MyClass o) { 


第 9 条 : ee equals DISE, in 


hashCode 


DIRE RIRE TA A hashcose 方法 。 CEE (iam S 
equals FiZHWIA F, WBITE nasncoae AVF ° WANA 


话 ， 束 会 违反 object,nashcode 的 通用 约定 ， 从 而 导致 该 类 无 法 结合 所 
有 基于 散 列 的 集合 一 起 正常 工作 ， 这 样 的 集合 包括 Hashwap 、 Hashset 


和 Hashtable 
下 面 是 约定 的 内 容 ， 摘 目 object 规范 [JavaSE6]: 


。 在 应 用 程序 的 执行 期 间 ， 只 要 对 象 的 equals 方法 的 比较 操作 所 用 
到 的 信息 没有 被 修改 ， 那 么 对 同一 个 对 象 调用 多 次 ， hashcoue 方 
法 都 必须 始终 如 一 地 返回 同一 个 整数 。 在 同一 个 应 用 程序 的 多 次 
执行 过 程 中 ， 每 次 执行 所 返回 的 整数 可 以 不 一 致 。 

如 果 两 个 对 象 根 据 equals(object) 方法 比较 是 相等 的 ， 那 么 调用 这 
的 hashcode 方法 都 必须 产生 同样 的 整数 


aR 

如 果 两 个 对 象 根据 equals(Object ) 方法 比较 是 不 相等 的 ， 那么 调用 
这 两 个 对 象 中 任意 一 个 对 象 的 nasncode 方法 ， 则 不 一 定 要 产生 不 
同 的 整数 结果 。 但 是 程序 员 应 该 知道 ， 给 不 相等 的 对 象 产生 截然 
不 同 的 整数 结果 ， 有 可 能 提高 散 列 表 (hash table) 的 性 能 。 


AVIRA fii, nasncode MIBRMI KEAN CEPR: PASAT RURA 
AHEHE (hash code) 。 根 据 类 的 equas 方法 ， 两 个 截然 不 
同 的 实例 在 逻辑 上 有 可 能 是 相等 的 ， 但 是 ， 根 据 object 类 的 hashcode 
方法 ， 它 们 仅仅 是 两 个 没有 任何 共同 之 处 的 对 象 。 因 此 ， 对 和 象 的 
hashcode 方法 返回 两 个 看 起 来 是 随机 的 整数 ， 而 不 是 根据 第 二 个 约定 
所 要 求 的 那样 ， 返 回 两 个 相等 的 整数 。 


例如 ， 考虑 下 面 这 个 极为 简单 的 PhoneNumber Ra 它 的 equals 万 法 是 
根据 第 8 条 中 给 出 的 “诀窍 ”构造 出 来 的 : 


public final class PhoneNumber { 
private final short areaCode; 
private final Short prefix; 


private final short lineNumber; 


public PhoneNumber ( int areaCode, int prefix, 


int lineNumber) { 


rangeCheck(areaCode, 999 , "area code" ); 


rangeCheck(prefix, 999 , "prefix" ); 


rangeCheck(lineNumber, 9999 , "line number" ); 


this .areaCode = ( short ) areaCode; 


this .prefix = ( short ) prefix; 


this .lineNumber = ( short ) lineNumber; 


private static void rangeCheck ( int arg, int max, 


String name) { 


if (arg < © || arg > max) 


throw new IllegalArgumentException(name + 


@Override public boolean equals (Object o) { 


if (0 == this ) 


return true ; 


+ arg); 


if (!(0 instanceof PhoneNumber) ) 
return false ; 
PhoneNumber pn = (PhoneNumber )o; 
return pn.lineNumber == lineNumber 
&& pn.prefix == prefix 


&& pn.areaCode == areaCode; 


// Broken - no hashCode method 


// ... Remainder omitted 


假设 你 企图 将 这 个 类 与 hasnwap 一 起 使 用 : 
Map<PhoneNumber, String> m 


= new HashMap<PhoneNumber, String>(); 


m.put( new PhoneNumber( 707 , 867 , 5309 ), "Jenny" ); 


这 时 候 ， 你 可 能 期 望 m.get(new PhoneNumber(707, 867, 5309)) 会 返 
回 “Jenny”， 但 它 实 际 上 返回 的 是 nu 。 注 意 ， 这 里 涉及 两 个 


PhoneNumber 实例 : 第 一 个 被 用 于 插入 到 HashMap 中 ， 第 二 个 实例 与 第 
— FASS , 被 用 于 (试图 用 于 ) 获取 。 由 于 PhoneNumber RIE fe i 

hashcode AVIS, MAT SEN PASSES NEOUS, BAZ 
了 了 hashcode 的 约定 。 因此 ， put 方法 把 电话 号 码 对 象 存 放 在 一 个 散 

列 桶 (hash bucket) 中 ， get 方法 却 在 另 一 个 散 列 桶 中 查找 这 个 电话 
号 码 。 即 使 这 两 个 实例 正好 被 放 在 同一 个 散 列 桶 中 ， get 方法 也 必定 
会 返回 nu ， 因 为 hasnwap 有 一 项 优化 ， 可 以 将 每 个 项 相关 联 的 散 

列 码 缓存 起 来 ， 如 果 散 列 码 不 匹配 ， 也 不 必 检 验 对 象 的 等 同性 。 


修正 这 个 问题 非常 简单 ， 只 需 为 PhoneNumber 类 提供 一 个 适当 的 
hashcode 方法 即 可 。 那 么 ， nashcode 方法 应 该 是 什么 样 的 呢 ? 编 写 一 
个 合法 但 并 不 好 用 的 hashcode 方法 没有 任何 价值 。 例 如 ， 下 面 这 个 方 
法 总 是 合法 ， 但 是 永远 都 不 应 该 被 正式 使 用 : 


// The worst possible legal hash function - never use! 


@Override public int hashCode () { return 42 ; } 


上 面 这 个 nashcode WIA ASH, AN EHR TMS TRE eAB 
EA BOWES o ERAS, BANE tte POT AB GR ERY 

散 列 码 。 因 此 ， 每 个 对 象 都 被 映 冉 到 同一 个 散 列 桶 中 ， 使 散 列 表 退 化 
为 链表 (linked list) 。 它 使 得 本 该 线性 时 间 运 行 的 程序 变 成 了 以 平方 

Ie Naa ee ana 
常 工作 。 


一 个 好 的 散 列 函 数 通 向 倾 问 于 “为 不 相等 的 对 象 产 生 不 相等 的 散 列 
码 ”。 这 正 是 hashcode 约定 中 第 三 条 的 含义。 理想 情况 下 ， 散 列 函 数 
应 该 把 集合 中 不 相等 的 实例 均匀 地 分 不 到 所 有 可 能 的 散 列 值 上 。 要 想 
完全 达到 这 种 理想 的 情形 是 非常 困难 的 。 笠 和 运 的 是 ， 相 对 接近 这 种 理 
想 情 形 则 并 不 太 兰 难 。 下 面 给 出 一 种 简单 的 解决 办 法 : 


1. ”把 某 个 非 零 的 常数 值 ， 比 如 说 17， 你 存在 一 个 名 为 


result 的 int 类 型 的 变量 中 


2. ”对 于 对 象 中 每 个 关键 域 f GR equas 方法 中 涉及 的 每 
个 域 ) ， 完 成 以 下 步骤 : 


a. 为 该 域 计 算 int 类 型 的 散 列 码 。: 
i. 如 果 该 域 是 boolean 类 型 则 计算 (Gr? als o A 


li. 如 果 该 域 是 byte `~ char `~ short 或 者 int 类 型 ， 
则 计算 (int)f 


iii. 如 果 该 域 是 long 类 型 则 计算 (int)(f ^ (f >>> 32)) 


iv. 如 果 该 域 是 fioat 类 型 ， 则 计算 


Float.floatToIntBits(f) 


v. 如果 该 域 是 uouble 类 型 ， 则 计算 
Double.doubleToLongBits(f) , 然后 按照 步骤 2.a.jji， 为 得 到 
的 long 类 型 值 计 算 散 列 值 È 


vi. 如 果 该 域 是 一 个 对 象 引 用 ， 并 且 该 域 的 equals 方法 

通过 递归 地 调用 equas 的 方式 来 比较 这 个 域 ， 则 同样 为 
这 个 域 递 归 地 调用 hashCode 。 如 果 需 要 更 复杂 的 比较 ， 

则 为 这 个 域 计 算 一 个 “范式 (canonical 

representation) ”， 然 后 针对 这 个 范式 调用 hashcode 。 如 
果 这 个 域 的 值 为 niu ， 则 返回 0 (或 者 其 他 某 个 常数 ， 


但 通常 是 0) 


vii. 如 果 该 域 是 一 个 数组 ， 则 要 把 每 一 个 元 素 当 做 单独 
的 域 来 处 理 。 也 瓯 是 说 ， 递 归 地 应 用 上 述 规 则 ， 对 每 个 
重要 的 元 了 率 计算 一 个 散 列 码 ， 然 后 根据 步骤 2.b 中 的 做 法 
把 这 些 散 列 值 组 合 起 来 。 如 果 数 组 域 中 的 每 个 元 素 都 很 
重要 ， aini 
Arrays.hashCode Y j 


b. 按照 下 面 的 公式 ， 把 步骤 2.a 中 计算 得 到 的 散 列 码 。 
合并 到 result 中 : 


result = 31 * result + C; 


3. 返回 result。 


4. 写 完 了 nashcode 方法 之 后 ， 问 问 目 己 “相等 的 实例 是 否 
都 具有 相等 的 散 列 码 *”。 要 编写 单元 测试 来 验证 你 的 推 
断 。 如 果 相 等 实例 有 着 不 相等 的 散 列 码 ， 则 要 找 出 原 
A, HEER 。 


在 散 列 码 的 计算 过 程 中 ， 可 以 把 IRE (redundant field) 排除 在 

外 。 换 句 话 说， 如果 一 个 域 的 值 可 以 根据 参与 计算 的 其 他 域 值 计算 出 
来 ， 则 可 以 把 这 样 的 域 排除 在 外 。 必 须 排除 equais 比较 计算 中 没有 用 
到 的 任何 域 ， 否 则 很 有 可 能 违反 nasncode 约定 的 第 二 条 ° 


上 述 步 又 1 中 用 到 了 一 个 非 零 的 初始 值 ， 因 此 步 又 2.a 中 计算 的 做 列 值 

为 0 的 那些 初始 域 ， 会 影响 到 散 列 值 。 如 采 步 又 1 中 的 初始 值 为 0， 则 整 
个 散 列 值 将 不 受 这 些 初始 域 的 影响 ， 因 为 这 些 初始 域 会 增加 冲突 的 可 
能 性 。 值 a7 则 是 任 选 的 。 


步骤 2.b 中 的 乘法 部 分 使 得 散 列 值 依赖 于 域 的 顺序 ， 如 采 一 个 类 包含 多 
个 相似 的 域 ， 这 样 的 乘法 运算 就 会 产生 一 个 更 好 的 散 列 函数 。 例 如 ， 
UIR string BONERS TIX SALE, IA Aer BEM AA 
ASA BRS BEES o Z Pr bheee31, ANE eh aT 
素数 。 如 采 乘 数 是 偶数 ， 并 且 乘 法 海 出 的 话 ， 信 息 束 会 丢失 ， 因 为 与 2 
相 乘 等 价 于 位 移 运 算 。 使 用 素数 的 好 处 并 不 很 明显 ， 但 是 习惯 上 都 使 
用 和 聂 数 来 计算 散 列 结 末 。31 有 个 很 好 的 特性 ， 即 用 位 移 和 诚 法 来 代 符 
乘法 ， 可 以 得 到 更 好 的 性 能 ， 31 * i == (i << 5) - i 。 现 代 的 VM 可 以 
目 动 完成 这 种 优化 。 


现在 我 们 要 把 上 述 的 解决 办 法 用 到 PhoneNumber 类 中 它 有 三 个 关键 
域 ， 都 是 Short 类 型 


@Override public int hashCode () { 


int result = 17 ; 


result = 31 * result + areaCode; 


result = 31 * result + prefix; 


result = 31 * result + lineNumber; 


return result; 


因为 这 个 方法 返回 的 结果 是 一 个 简单 的 、 确 定 的 计算 结果 ， 它 的 输入 
只 是 PhoneNumber 实例 中 的 三 个 关键 域 ， 因此 相等 的 PhoneNumber 显然 
都 会 有 相等 的 散 列 码 ° 实际 上 ， 对 于 PhoneNumber 的 hashCode 实现 而 
言 ， 上 面 这 个 方法 是 非常 合理 的 ， 相 当 于 Java 平 台 类 库 中 的 实现 。 它 
的 做 法 非常 简单 ， 也 相当 快捷 ， 恰 当地 把 不 相等 的 电话 号 码 分 散 到 不 
同 的 散 列 桶 中 。 


如 条 一 个 类 是 不 可 变 的 ， 并 且 计 算 散 列 码 的 开销 也 比较 大 ， 残 应 该 考 
虑 把 散 列 码 缓 存在 对 象 内 部 ， 而 不 是 每 次 请 求 的 时 候 都 重新 计算 散 列 
码 。 如 采 你 觉得 这 种 类 型 的 大 多 数 对 象 会 被 用 作 散 列 键 \hash 
keys) ， 就 应 该 在 创建 实例 的 时 候 计算 散 列 码 。 人 否则 ， 可 以 选择 * EA 
HILA (lazily initialize) ” 散 列 码 ， 一 直到 hasncode 被 第 一 次 调用 的 
时 候 才 初始 化 ( 见 第 71 条 ) 现在 尚 不 清楚 我 们 的 PhoneNumber REG 
值得 这 样 处 理 ， 但 可 以 通过 它 来 说 明 这 种 方法 该 如 何 实现 : 
// Lazily initialized, cached hashCode 
private volatile int hashCode; // (See item 71) 
@Override public int hashCode () { 
int result = hashCode; 
if (result == 0) { 
result = 17 ; 


result = 31 * result + areaCode; 


result = 31 * result + prefix; 


result = 31 * result + lineNumber; 
hashCode = result; 


} 


return result; 


虽然 本 条 目 中 前 面 给 出 的 nashcode 实现 方法 能 够 获得 相当 好 的 散 列 画 
数 ， 但 是 它 并 不 能 产生 最 新 的 散 列 函数 ， 截 止 发 行 版 本 1.6，Java 平 台 
类 库 也 没有 提供 这 样 的 散 列 函数 。 编 写 这 种 散 列 钞 数 是 个 研究 课题 ， 
最 好 留 给 数学 家 和 理论 方面 的 计算 机 科学 家 来 完成 。 也 许 Java 平 台 的 
下 一 个 发 行 版 本 将 会 为 它 的 类 提供 这 种 最 佳 的 获 列 函数 ， 并 提供 一 些 
实用 方法 来 帮助 普通 的 程序 员 构 造 出 这 样 的 散 列 男 数 。 与 此 同时 ， 本 
条 目 中 介绍 的 方法 对 于 绝 大 多 数 应 用 程序 而 言 已 经 足够 了 。 
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然 这 样 的 散 列 函数 运行 起 来 可 能 更 快 ， 但 是 它 的 效果 不 见得 会 好 ， 可 
能 会 导致 散 列 表 慢 到 根本 无 法 使 用 。 特 别 是 在 实践 中 ， 散 列 函 数 可 能 
面临 大 量 的 实例 ， 在 你 选择 名 略 的 区 域 中 ， 这 些 实例 仍然 区 别 非常 

大 。 如 采 十 这 样 ， 散 列 函数 束 会 把 所 有 这 些 实例 映射 到 极 少数 的 获 列 
码 上 ， 基 于 散 列 的 集合 将 会 显示 出 平方 级 的 性 能 指标 。 这 不 仅仅 是 个 
理论 问题 。 在 Java 1.2 发 行 版 本 之 前 实现 的 string 散 列 函数 至 多 只 检 
查 16 个 字符 ， 从 第 一 个 字符 开始 ， 在 整个 字符 串 中 均匀 选取 。 对 于 像 
URL 这 种 层次 状 名 字 的 大 型 集合 ， 该 散 列 函数 正好 表现 出 了 这 里 所 提 
到 的 病态 行为 。 


Java 平 台 类 库 中 的 许多 类 ， 比如 String ` Integer 和 Date , 都 可 以 
把 它们 的 nashcoue 方法 返回 的 确切 值 规定 为 该 实例 值 的 一 个 函数 。 一 
般 来 说 ， 这 并 不 是 个 好 主意 ， 因 为 这 样 做 广 格 地 限制 了 在 将 来 的 版 本 
中 改进 散 列 函数 的 能 力 。 如 果 没 有 规定 散 列 函数 的 细节 ， 那 么 当 你 发 
现 了 它 的 内 部 缺陷 时 ， 就 可 以 在 后 面 的 发 行 版 本 中 修正 它 ， 确 信 没 有 
任何 客户 病 会 依赖 于 散 列 钞 数 返回 的 确切 值 。 


第 10 条 : AB Bin toString 


HEIR java.tang.object 提供 了 tostring 方法 的 一 个 实现 ， 但 它 返 回 的 字 
符 串 通常 不 是 类 的 用 户 所 期 望 看 到 的 。 它 包 侣 类 的 名 称 ， 以 及 一 

个 “@” 符 号 ， 接 着 是 散 列 码 的 无 符号 十 六 进 制 表示 法 。 例 如 “ 
PhoneNumber@163b91 ”。 toString 的 通用 约定 之 处 ， 被 返回 的 字符 串 应 该 
是 一 个 “简洁 的 ， 但 信息 丰富 ， 并 且 易 于 阅读 的 的 表达 形 

式 ”[JavaSE6] 9 尽管 有 人 认为 “ PhoneNumber@163b91 ”算得 上 是 简洁 和 易于 
阅读 了 ， 但 是 与 “(707)867-5309” 比 较 起 来 ， 它 还 算 不 上 是 信息 丰富 
的 。 tostring 的 约定 进一步 之 处 , “建议 所 有 的 子 类 都 覆盖 这 个 方 
法 。” 这 是 一 个 很 好 的 建议 ， 真 的 ! 


昌 然 遵守 toString 的 约定 并 不 像 遵 守 equals 和 hashCode 的 约定 (JL 

第 8 条 和 第 9 条 ) MAER, 但是， 把 供 好 的 tostring 笑 现 可 以 使 类 历 
REMETE ° STAB BAG printin > printf ` FIF PEKERE 

从 ( + ) 以 及 assert 或 者 被 调试 需 打 印 出 来 时 ， toString 方法 会 被 
自动 调用 。 (Java 1.5 发 行 版 本 在 平台 中 增加 了 prince 方法 ， 还 提供 

了 包括 string.format 的 相关 方法 ， 与 C 语 言 中 的 sprint 相似 。) 


WRH PhoneNumber 提供 了 好 的 toString 六 那么 ， 要 产生 有 用 的 诊 
WA ASAE AD : 


System.out.printin( "Failed to connect: " + phoneNumber); 


MRa] tostring 方法 ， 程 序 员 都 将 以 这 种 方式 来 产生 诊断 消 
AA, (BEWARE i tostring 方法 ， 广 生 的 消 轧 将 难以 理解 。 提 供 


含 这 些 实例 的 引用 的 对 象 ， 特 别 是 集合 对 象 。 打 印 map 时 有 下 面 这 两 
条 消息 : “ Jenny=Phonenumber@163b91 ”和 “ jenny=(468)867-5369 ”， 你 更 愿意 


看 到 哪 一 个 ? 


碍 笠原 应 历 看 ， tostring TIAMAT RR PE SHUT A ae IER 
信息 ， 璧 如 上 述 电 话 号 码 例子 那样 。 如 果 对 象 太 大 ， 或 者 对 象 中 包含 
的 状态 信息 难以 用 字符 串 来 表达 ， 这 样 做 加 有 点 不 切实 际 。 在 这 种 情 
WF, toString 应 该 返回 一 个 摘要 信息 ， 例如 ” Manhattan white pages 

(1487536 listings) ” #4“ Thread[main, 5, main) ” ° 情况 下 ， 字 符 串 应 


Las 描述 的 (self-explanatory) , ( thread 例子 不 满足 这 样 的 要 


在 实现 tostring 的 时 候 ， 必 须要 做 出 一 个 很 重要 的 决定 : 是 否 在 文档 
中 指定 返回 值 的 格式 。 对 于 值 类 (value class) ， 比 如 电话 号 码 类 、 捧 
阵 类 ， 也 建议 这 么 做 。 指 定格 式 的 好 处 是 ， 它 可 以 被 用 作 一 种 标准 
的 、 明 确 的 、 适 合 人 阅读 的 对 象 表示 法 。 这 种 表示 法 可 以 用 于 输入 和 
输出 ， 以 及 用 在 永久 的 适合 人 类 阅读 的 数据 对 象 中 。 例 如 XML 文档 。 
如 果 你 指定 了 格式 ， 最 后 再 提供 一 个 相 匹 配 的 静态 工厂 或 者 构造 妖 ， 
以 便 程 序 员 可 以 很 容易 地 在 对 象 和 它 的 字符 串 表示 法 之 间 来 回转 换 。 
Java 平 台 类 库 中 的 许多 值 类 都 采用 了 这 种 做 法 ， 包 括 BigInteger 
Bigdecimal 和 绝 大 多 数 苏 的 基本 类 型 包装 类 (boxed primitive class) ° 


指定 tostring 返回 值 的 格式 也 有 不 足 之 处 ， 如 采 这 个 类 已 经 被 广泛 使 
用 ,一 旦 指定 格式 ， 丈 必须 始终 如 一 地 坚持 这 种 格式 。 程 序 员 将 会 编 
写 出 相应 的 代码 来 解析 这 种 字符 串 表示 法 、 产 生字 符 串 表示 法 ， 以 及 
把 字符 串 表 示 法 伦 入 到 持久 的 数据 中 。 如 采 将 来 的 发 行 版 本 中 改变 了 
这 种 表示 法 ， 束 会 破坏 他 们 的 代码 和 数据 ， 他 们 当然 会 抱怨 。 如 采 不 
指定 格式 ， 束 可 以 保留 灵活 性 ， 便 于 在 将 来 的 发 行 版 本 中 增加 信息 ， 
或 者 改进 格式 。 


FEVER EEN RETA ERIN, ABD IZ TE TE FG ZEA Rk © W 
ee aaa re 下 面 是 第 9 条 中 
PhoneNumber 类 时 toString 7 : 


Xt 


/** 


* Returns the string representation of this phone number. 


* The string consists of fourteen characters whose format 


* is "(XXX) YYY-ZZZZ", where XXX is the area code. YYY is 


* the prefix, and ZZZZ is the line number. (Each of the 


* capital letters represents a single decimal digit. ) 


* If any of the three parts of this phone number is too small 
* to fill up its field, the field is padded with leading zeros. 
* For example, if the value of the line number is 123, the last 


* four characters of the string representation will be "0123". 


* Note that there is a single space separating the closing 
* parenthesis after the area code from the first digit of the 
* prefix. 
=y 
@Override public String toString () { 
return String.format( "(%03d) %03d-%04d" , 


areaCode, prefix, lineNumber); 


e ， 那 么 文档 注释 部 分 也 应 该 有 如 下 所 示 的 指 
ZN A: 


JEF 
* Returns a brief description of this potion. The exact details 


* of the representation are unspecified and subject to change, 


@Override public String toString () (ra 


HY FAB EE RAF FS SUE Ts eT SE TE TK A FEAR, TE 
读 到 这 段 注 释 之 后 ， 一 旦 格式 被 改变 ， 则 只 能 目 己 承担 后 条 。 


无 论 是 否 指定 格式 ， ABA tostring KRAEPA SHIT Alea, Fete 


PAPEL IREZ © GED, phoneNumper 类 应 该 包含 针对 area code ` 
prefix 和 line number 的 访问 方法 。 如 果 不 这 么 做 ， 残 会 迫使 那些 需要 这 
些 信息 的 程序 员 不 得 不 目 己 去 解析 这 些 字 符 串 。 除 了 降低 了 程序 的 性 
能 ， 使 得 程序 员 们 去 做 这 些 不 必要 的 工作 之 外 ， 这 个 解析 过 程 也 很 容 
易 出 销 ， 会 导致 系统 不 稳定 ， 如 果 格 式 发 生变 化 ， 还 会 导致 系统 怖 
泪 。 如 果 没 有 提供 这 些 访问 方法 ， 即 使 你 已 经 指明 了 字符 串 的 格式 是 
可 以 变化 的 ， 这 个 字符 串 格 式 也 成 了 事实 上 的 API。 


B11: ia he E clone 


Cloneable 接口 的 目的 是 作为 对 象 的 的 一 人 1 mixinjž LI (mixin 
interface) (W185) ， 表 明 这 样 的 对 象 允 许 克 隆 (clone) ° H 
的 是 ， 它 并 没有 成 功 地 达到 这 个 目的 。 其 主要 的 缺陷 在 于 ， 它 缺少 一 
个 clone 方法 ， Object 的 clone 方法 是 受 保护 的 j 如 果 不 借助 于 反 
ft (reflection) ( 见 第 53 条 ) ,就 不 能 仅仅 因为 一 个 对 象 实现 了 
Cloneable , 束 可 以 调用 clone 方法 。 即使 是 反射 调用 也 可 能 会 是 该 ， 
因为 不 能 保证 该 对 象 一 定 具 有 可 访问 的 cioe 方法 。 尽 管 存在 这 样 那 
样 的 缺陷 ， 这 项 设施 仍然 被 广泛 地 使 用 着 ， 因 此 值得 我 们 进一步 地 了 
解 。 本 条 目 将 告诉 你 如 何 实现 一 个 行为 恨 好 的 clone 方法， 并 讨论 何 
时 适合 这 样 做 ， 同 时 也 简单 地 讨论 了 其 他 的 可 替换 做 法 。 


既然 cioneable 并 没有 包含 任何 方法 ， 那 么 它 到 底 有 什么 作用 昵 ? € 
决定 了 object 中 受 保护 的 cioe 方法 实现 的 行为 : 如 果 一 个 类 实现 
ne Cloneable , Object 的 clone Fr VRE IAT RR RE I , 否则 
就 会 抛 出 CloneNotSupportedException ay cd 这 是 接口 的 一 种 极端 非典 型 
的 用 法 ， 也 不 值得 效仿 。 通 常情 况 下 ， 实 现 接 口 是 为 了 表明 类 可 以 为 
它 的 客户 做 些 什 么 。 然 而 ， 对 于 cloneavle 接口 ， 它 改变 了 超 类 中 受 
保护 的 方法 的 行为 。 


如 果实 现 cioneable 接口 是 要 对 某 个 类 起 到 租用 ， 类 和 它 的 所 有 超 类 
都 必须 遵守 一 个 相当 复杂 的 、 不 可 实施 的 ， 并 且 基 本 上 没有 文档 说 明 
的 协议 。 由 此 得 到 一 种 a SOK (extralinguistic) 机 制 : 无 需 调 用 
构造 器 就 可 以 创建 对 象 。 


clone 方法 的 通用 约定 是 非常 弱 的 ， 下 面 是 来 目 java.lang.object 规范 
中 的 约定 内 容 [JavaSE6]: 


创建 和 返回 对 象 的 一 个 拷贝 。 这 个 “拷贝 ”的 精确 仿 义 取决 于 该 对 象 的 
类 。 一 般 的 含义 是 ， 对 于 任何 对 象 x, RAA 


x.clone() != x 


将 会 是 true ， 并 且 ， 表 达 式 


x.clone().getClass() == x.getClass() 


将 会 是 true ， 但 这 些 都 不 是 绝对 的 有 要求 。 虽 然 通常 情况 下 ， 表 达 式 


x.clone().equals(x) 


将 会 是 true , (Hoe, tA PATH BOK o FUT RAVES 
导致 创建 它 的 类 的 一 个 新 实例 ， 但 它 同 时 也 会 要 求 拷贝 内 部 的 数据 结 
构 。 这 个 过 程 中 没有 调用 构造 器 


这 个 约定 存在 几 个 问题 。“ 不 调用 构造 右 ” 的 规定 太 强 硬 了 。 行 为 民 好 
的 clone 方法 可 以 调用 构造 器 来 创建 对 象 构造 之 后 再 复制 内 部 数 
据 。 。 如果 这 个 类 是 final HSJ, clone 甚至 可 能 会 返回 一 个 由 构造 恬 仓 j 
建 的 对 象 。 


然而 ， x.clone().getClass() 通常 应 该 等 同 于 x.getClass() 的 规定 又 太 软 
弱 了 。 在 实践 中 ， 程 序 员 会 假设 : 如 有 果 他 们 扩展 了 一 个 类 ， 并 且 从 子 
类 中 调用 了 super.clone ， 返 回 的 对 象 束 将 是 该 子 类 的 实例 。 超 类 能 够 
提供 这 种 功能 的 唯一 途径 是 ， 返 回 一 个 通过 调用 super.clone 而 得 到 的 
对 象 。 如 果 clone 方法 返回 一 个 由 构造 器 创建 的 对 象 ， 它 束 得 到 有 错 


误 的 类 因此 ， MRR J JE final FPL clone Wipes SUB THR 
A] —P GIL VA/A super.cione MFE R ° WARRANT BRAS 
守 这 条 规则 ， 那么 调用 super .clone 最 终 会 调用 Object 的 clone Wy 
法 ， 从 而 创建 出 正确 类 的 实例 。 这 种 机 制 大 体 上 类 似 于 目 动 的 构造 器 
调用 链 ， 只 不 过 它 不 是 强制 要 求 的 。 


从 1.6 发 行 版 本 开始 ， caoneable 接口 并 没有 清楚 地 指明 ， 一 个 类 在 实 
现 这 个 接口 时 应 该 夭 担 哪些 责任 。 EEE, XIT cloneaple KI 
K, ENTE EZ CRA TARE AWAAHY cioe JIE ° ARTA 
况 下 ， 除 非 该 类 的 所 有 超 类 都 提供 了 行为 民 好 的 cioe 实现 ， 无 论 十 
公有 的 还 古 受 保护 的 ， 否 则 ， 都 不 可 能 这 么 做 。 


假设 你 希望 在 一 个 类 中 实现 caoneable ， 并 且 它 的 超 类 都 提供 行为 良 
好 的 cione 方法 。 你 从 super.clone0 中 得 到 的 对 象 可 能 会 接近 于 最 终 
要 返回 的 对 象 ， 也 可 能 相差 其 远 ， 这 要 取决 于 这 个 类 的 本 质 。 从 每 个 
超 类 的 角度 来 看 ， 这 个 对 象 僵尸 原始 对 象 功能 完整 的 克隆 (clone) ° 
在 这 个 类 中 声明 的 域 (如 果 有 的 话 ) 将 等 同 于 被 克隆 对 象 中 相应 的 
域 。 如 果 每 个 域 包 含 一 个 基本 类 型 的 值 ， 或 者 包含 一 个 指 癌 不 可 变 对 
象 的 引用 ， 那 么 被 返回 对 象 则 可 能 正 是 你 所 需要 的 对 象 ， 在 这 种 情况 
下 不 需要 再 做 进一步 处 理 。 例 如 ， 第 9 条 中 的 phonenumber 类 正 是 如 
此 。 在 这 种 情况 下 ， 你 所 需要 做 的 ， 除 了 声明 实现 了 cioneable 之 
外 ， 就 是 对 object 中 受 保 护 的 cione 方法 提供 公有 的 访问 途径 : 


@Override public PhoneNumber clone () { 


try { 


return (PhoneNumber) super .clone(); 


} catch (CloneNotSupportedException e) { 


throw new AssertionError(); // Can't happen 


注意 上 述 的 clone 方法 返回 的 是 PhoneNumber , 而 不 是 Object 从 
Java 1.5 发 行 版 本 开始 ， 这 么 做 是 合法 的 ， 也 是 我 们 所 期 待 的 ， 因 为 1.5 
发 行 版 本 中 引入 了 PERERA (covariant return type) 作为 泛 型 。 
换 句 话说 ， 目 前 覆盖 方法 的 返回 类 型 可 以 是 被 履 盖 方法 的 返回 类 型 的 
子 类 了 。 这 样 有 助 于 罗 善 方法 提供 更 多 关于 被 返回 对 象 的 信息 ， 并 且 
在 客户 端 中 不 必 进 行 转换 。 由 于 object.clone 返回 object ， 

PhoneNumber .clone 必须 在 返回 super .clone() 的 结果 之 前 将 它 转换 。 这 里 
所 现 TRE: Ke RELEASE TREE BEEP AKIF 


lf ° 


如 果 对 象 中 包含 的 域 引 用 了 可 变 的 对 象 ， 使 用 上 述 这 种 简单 的 caone 
实现 可 能 会 导致 灾难 性 的 后 采 。 例 如 ， 考 虑 第 6 条 中 的 stack R: 


public class Stack { 


private Object[] elements; 


private int size = 0; 


private static final int DEFAULT_INITIAL_CAPACITY = 16 ; 


public Stack () { 


this .elements = new Object[DEFAULT_INITIAL_CAPACITY]; 


public void push (Object e) { 


ensureCapacity(); 


elements[size++] = e; 


public Object pop () { 
if (size == 0 ) 
throw new EmptyStackException(); 
Object result = elements[--size]; 
elements[size] = null ; // Eliminate obsolete reference 


return result; 


// Ensure space for at least one more element. 
private void ensureCapacity () { 
if (elements.length == size) 


elements = Arrays.copyOf(elements, 2 * size + 1 ); 


假设 你 希望 把 这 个 类 做 成 可 克隆 的 (cloneable) 。 如 果 它 的 cione 77 
法 仅仅 返回 super.clone() , 这 样 得 到 的 Stack 实例 ， 在 其 size 域 中 
具有 正确 的 值 ， 但 是 它 的 elements 域 将 引用 与 原始 stack 实例 相同 的 
数组 。 修 改 原始 的 实例 会 破坏 被 克隆 对 象 中 的 约束 条 件 ， 反 之 亦 然 。 


RAREZA, ANETKA ESIC NR, BOOM 
Nul1PointerException 异常 9 

如 果 调 用 stac 类 中 唯一 的 构造 絮 ， 这 种 情况 就 永远 不 会 发 生 。 Ker 
E, cioe AAR EAT Pia; WORREN SM E ERIA 
XIR, HAREM UE RETR PIIRRE (invariaant) ° H 
了 使 Stack 类 中 的 clone 方法 正常 地 工作 ， 它 必须 要 拷贝 栈 的 内 部 信 
息 。 最 容易 的 做 法 是 ， 在 elements 数 组 中 递归 的 调用 clone : 


@Override public Stack clone () { 
try BY 
Stack result = (Stack) super .clone(); 
result.elements = elements.clone(); 
return result; 
} catch (CloneNotSupportedException e) { 


throw new AssertionError(); 


注意 ， 我 们 不 一 定 要 将 elements.clone() 的 结果 转换 成 object ° A 
Java 1.5 发 行 版 本 起 ， 在 数组 上 调用 cione 返回 的 数组 ， 其 编译 时 类 型 
与 被 克隆 数组 的 类 型 相同 。 


还 要 注意 ， 如 果 elements 域 是 final AN, ty Sea BEIE He LIE, 
因为 clone 方法 是 被 禁止 给 elements PURSE ° De PARAS [Al 
题 : clone ZIARE EXTRA Final ATIE E VEE T AFB 
， 除 非 在 原始 对 象 和 克隆 对 象 之 间 可 以 安全 地 共享 此 可 变 对 象 。 为 了 
HERA A SOREN, AREA BEN SELAH final 修饰 符 。 


递归 地 调用 cione 有 时 还 不 够 。 例 如 ， 假 设 你 正在 为 一 个 散 列 表 编 写 
clone 方法 ， 它 的 内 部 数据 包含 一 个 散 列 通 数 组 ， 每 个 散 列 通 都 指 
器“ 键 一 一 值 ” 对 链表 的 第 一 个 项 ， 如 果 桶 是 空 的 ， 则 为 nu 。 出 于 
性 能 方面 的 考虑 ， 该 类 实现 了 它 自 己 的 轻 量 级 单 同 链表 ， 而 没有 使 用 
Java 内 部 的 savavucanuinkeatase 该 类 如 下 : 


public class HashTable implements Cloneable { 


private Entry[] buckets = ...; 


private static class Entry { 


final Object key; 


Object value; 


Entry next; 


Entry(Object key, Object value, Entry next) { 


this .key = key; 


this .value = value; 


this .next = next; 


// Remainder omitted 


0 0800 a aS 


// Broken - results in shared internal state! 
@Override public HashTable clone () { 
try { 
HashTable result = (HashTable) super .clone(); 
result.buckets = buckets.clone(); 
return result; 
} catch (CloneNotSupportedException e) { 


throw new AssertionError(); 


虽然 被 元 隆 对 象 有 它 目 己 的 散 列 棚 数 组 ， 但 是 ， 这 个 数组 引用 的 链表 
与 原始 对 象 是 一 样 的 ， 从 而 很 容易 引起 克隆 对 象 和 原始 对 象 中 不 确定 
的 行为 。 为 了 修正 这 个 问题 ， 必 须 单独 地 拷贝 并 组 成 每 个 桶 的 链表 。 
Be PH ie OBE 


public class HashTable implements Cloneable { 


private Entry[] buckets = ...; 


private static class Entry { 


final Object key; 


Object value; 


Entry next; 


Entry(Object key, Object value, Entry next) { 


this .key key; 


this .value = value; 


this .next = next; 


// Recursively copy the linked list headed by this entry 


Entry deepCopy () { 


return new Entry(key, value, 


next == null ? null : next.deepCopy()); 


@Override public HashTable clone () { 


try E 


HashTable result = (HashTable) super .clone(); 
result.buckets = new Entry[buckets.length]; 
for ( int i= 0; i < buckets.length; i++) 
if (buckets[i] != null ) 
result.buckets[i] = buckets[i].deepCopy(); 
return result; 
} catch (CloneNotSupportedException e) { 


throw new AssertionError(); 


. // Remainder omitted 


私有 类 vashtable.entry 被 加 强 了 ， 它 支持 一 个 “深度 拷贝 (deep 

copy) "D ° HashTable 上 的 clone EAB ST PAY R ` BT 
的 buckets 数组 ， 并 且 裔 历 原始 的 buckets 数组 ， 对 每 一 个 非 空 散 列 
桶 进行 深度 拷贝 。 entry 类 中 的 深度 拷贝 方法 递归 地 调用 它 目 身 ， 以 
HERE MER 〈 它 是 链表 的 头 结 点 ) 。 虽 然 这 种 方法 很 灵活 ， 如 果 
散 列 桶 不 是 很 长 的 话 ， 也 会 工作 得 很 好 ， 但 是 ， 这 样 克 隆 一 个 链表 并 
不 是 一 个 好 方法 ， 因 为 针对 列表 中 的 每 个 元 素 ， 它 都 要 消耗 一 端 栈 空 
间 。 如 果 链 表 比 较 长 ， 这 很 容易 导致 栈 淤 出 。 为 了 避免 发 生 这 种 情 
况 ， 你 可 以 在 deepcopy FAYE (iteration) 代替 递归 (recursion) : 


// Iteratively copy the linked list headed by this Entry 


Entry deepCopy () { 


Entry result = new Entry(key, value, next); 
for (Entry p = result; p.next != null ; p = p.next) 
p.next = new Entry(p.next.key, p.next.value, p.next.next); 


return result; 


克隆 复杂 对 象 的 最 后 一 种 办 法 是 ， 完 调用 super.cione ， 然 后 把 结果 对 
象 中 的 所 有 域 都 设置 为 它们 的 空白 状态 (virgin state) ， 然 后 调用 高 层 
(higher-level) 的 方法 来 重新 产生 对 象 的 状态 。 在 我 们 的 nasnhrable 例 
FF, buckets 域 将 被 初始 化 为 一 个 新 的 艇 列 桶 数组 ， 然 后 ， 对 于 正 
在 被 克隆 的 散 列 表 中 的 每 一 个 键 一 一 值 映射 ， 都 调用 put(key, value) 
方法 (上 面 没有 给 出 其 代码 ) 。 这 种 做 法 往往 会 产生 一 个 简单 、 合 理 
且 相 当 优 美的 cione 方法 ,但 是 它 运行 起 来 通常 没有 “直接 操作 对 象 
及 其 克隆 对 象 的 内 部 状态 的 clone 方法 " 快 


如 同 构 造 器 一 样 ， clone 方法 不 应 该 在 构造 的 过 程 中 ， 调 用 新 对 象 中 
任何 非 final 的 方法 〈 见 第 17 条 ) 。 如 果 cione 调用 了 一 个 被 覆盖 的 
方法 ， 那 么 在 该 方法 所 在 的 于 类 有 机 会 修正 它 在 克隆 对 象 中 的 状态 之 
前 ， 该 方法 残 会 先 被 执行 ， 这 样 很 有 可 能 会 导致 克隆 对 象 和 原始 对 象 
之 间 的 不 一 致 。 因 此 ， 上 一 段落 中 讨论 到 的 put(key，value) 方法 应 该 
要 么 是 tina 的 ， 要么 是 私有 的 (如果 是 私有 的 ， 它 应 该 算是 非 
final 公有 方法 的 “辅助 方法 [helper method]” ) 


Object 的 clone 方法 被 声明 为 可 抛 出 CloneNotSupportedException TE, 
(E fe tA) clone 方法 可 能 会 忽略 这 个 声明 公有 的 clone 2 
法 应 该 省 略 这 个 声明 ， 因 为 不 会 抛 出 受 检 腊 常 (checked exception) 的 
方法 与 会 抛 出 异常 的 方法 想必 ， 使 用 起 来 更 加 轻松 〈 见 第 59 条 ) 。 如 
果 专 门 为 了 继承 而 设计 的 类 [ 见 第 17 条 ] 覆 盖 了 caone FE, PETMAN 
的 cione 方法 就 应 该 模拟 opject.clone 的 行为 : 它 应 该 被 声明 为 
protected > HoH CloneNotSupportedException Re 并 且 该 类 不 应 该 实现 
Cloneable 接口 ‘J 这 样 做 可 以 使 子 类 具有 实现 或 者 不 实现 Cloneable 接 
口 的 目 由 ， 束 仿佛 它们 直接 扩展 了 objet 一 样 。 


还 有 一 点 值得 注意 。 如 果 你 决定 用 线程 安全 的 类 实现 cloneable P 
口 ， 要 记得 它 的 cione 方法 必须 得 到 很 好 的 同步 ， 就 像 任何 其 他 方法 
一 人 ( 见 第 66 条 ) ° Object 的 clone 方法 没有 同步 ， 因此 即使 很 满 
意 ， 可 能 也 必须 编写 同步 的 clone 方法 来 调用 super .clone 


位 而 言 之 ， 所 有 实现 了 caoneable 接口 的 类 都 应 该 用 一 个 公有 的 方法 
3B tit clone 。 此 公有 方法 首先 调用 super.clone , 然后 修正 任何 需要 修 
正 的 域 。 一 般 情况 下 ， 这 意味 着 要 拷贝 任何 包含 内 部 “深层 结构 ”的 可 
变 对 象 ， 并 用 指 癌 新 对 象 的 引用 代替 原来 指向 这 些 对 象 的 引用 。 虽 

PR, 这些 内 部 拷贝 操作 往往 可 以 通过 递归 地 调用 caone 来 完成 ， 但 这 
通常 并 不 是 最 佳 方法 。 如 采 该 类 只 包含 基本 类 型 的 域 ， 或 者 指向 不 可 
变 对 象 的 引用 ， 那 么 多 半 的 情况 是 没有 域 需 要 修正 。 这 条 规则 也 有 例 
外 ， 壁 如 ， 代 表 序 号 或 者 其 他 唯一 ID 值 的 域 ， 或 者 代表 对 象 的 创建 时 
Ee ONE i i 


真 的 有 必要 这 么 复杂 吗 ? 很 少 有 这 种 必要 。 如 果 你 扩展 一 个 实现 
Cloneable 接口 的 类 ， 那么 你 除了 实现 一 个 行为 恨 好 的 clone 方法 外 ， 
没有 别 的 选择 。 和 否则 ， Beer RE RAR ARERR REA, E 
EF MEA PELE TEN BE © PIN, SPARTA, SHOT RH IS 
有 太 大 的 意义 ， 因 为 被 拷贝 的 对 象 与 原始 对 象 没有 实质 的 不 同 。 
AP LEDS REA NIE DR eR TB I foe (copy 
constructor) FIL (copy factory) 。 找 贝 构造 器 只 是 一 个 构造 
器 ， 它 唯一 的 参数 类 型 是 包含 该 构造 器 的 类 ， 例 如 : 


public Yum (Yum yum) ; 


拷贝 工厂 是 类 似 于 拷贝 构造 器 的 静态 工厂 : 


public static Yum newInstance (Yum yum) ; 


拨 贝 构造 器 的 做 法 ， 及 其 静态 工厂 方法 的 变性 ， 都 比 cioneabie/cione 
方法 具有 更 多 的 优势 : 它们 不 依赖 于 某 一 种 很 有 风险 的 、 语 言 之 外 的 
对 象 创建 机 制 ， 它 们 不 要 求 遵 守 尚 未 制定 好 文档 的 规范 ， 它 们 不 会 与 
final 域 的 正常 使 用 发 生 冲 突 ， 它 们 不 会 抛 出 不 必要 的 受 检 异常 
(checked exception) ; 它们 不 需要 进行 类 型 转换 。 虽 然 你 不 可 能 把 找 
贝 构造 器 或 者 静态 工厂 放 到 接口 中 ， 但 是 由 于 coea 接口 缺少 一 
个 公有 的 cione 方法 ， 所 以 它 也 没有 提供 一 个 接口 该 有 的 功能 。 
此 ， 使 用 揽 贝 构造 器 或 者 拷贝 工厂 来 代 奉 cione 方法 时 ， 并 没有 放弃 
接口 的 功能 特性 。 


更 进一步 ， 找 贝 构造 器 或 者 拷贝 工程 可 以 市 一 个 参数 ， 参 数 类 型 是 通 
过 该 类 实现 的 接口 。 例 如 ， 按 照 惯例 ， 所 有 通用 集合 实现 都 提供 了 一 
NFE Ua 它 的 参数 类 型 为 collection 或 者 Map ° 基于 接口 的 找 
贝 构造 器 和 找 贝 工厂 (更 准确 的 叫 法 应 该 是 “转换 构造 器 (conversion 
constructor) ”和 转换 工厂 (conversion fatory) ) ， 人 允许 客户 选择 拷贝 
的 实现 类 型 ， 而 不 是 强迫 客户 接受 原始 的 实现 类 型 。 例 如 ， 假 设 你 有 
一 个 Hashset , 并 且 和 希望 把 它 揽 贝 成 一 个 Treeset ° clone 方法 无 法 
提供 这 样 的 功能 ， 但 是 用 转换 构造 器 很 容易 实现 :new Treeset(s) 


既然 cloneable 接口 具有 上 诉 那 么 多 问题 ， 可 以 肯定 地 说 ， 其 他 的 接 
口 都 不 应 该 扩展 (extend) 这 个 接口 ， 为 了 继承 而 设计 的 类 〈 见 第 17 
条 ) 也 不 应 该 实现 (implement) 这 个 接口 。 由 于 它 具 有 这 么 多 的 缺 

点 ， 有 些 专 家 级 的 程序 员 干 脆 从 来 不 去 窗 盖 caone 方法 ， 也 从 来 不 去 
调用 它 ， 除 非 拷 贝 数组 。 你 必须 清楚 一 点 ， 对 于 一 个 专门 为 了 继承 而 
设计 的 类 ， 如 果 你 未 能 提供 行为 良好 的 受 保护 的 (protected) cione 

a 它 的 子 类 了 束 不 可 能 实现 Cloneable 接口 


第 12 条 : 考虑 实现 Comparable 接口 


守 本 对 中 讨论 曲 其 他 方法 不 同 ， compareTo 方法 并 没有 在 object FE 
明 。 相 反 ， 它 是 Comparable 接口 中 唯一 的 方法 。 compareTo Feet 
许 进 行 简单 的 等 同行 比较 ， 而 且 允 许 执行 顺序 比较 ， 除 此 之 外 ， 它 与 
object 的 equis 方法 具有 相似 的 特征 ， 它 还 是 个 泛 型 。 类 实现 了 
comparable 接口 ， 就 表明 它 的 实例 具有 内 在 的 排序 关系 (natural 
ordering) 。 为 实现 comparable 接口 的 对 象 数组 进行 排序 束 这 么 人 简单: 


Arrays.sort(a); 


对 存储 在 集合 中 的 comparable 对 象 进 行 搜索 、 计 算 极限 值 以 及 目 动 维 
护 也 同样 简单 。 。 例 如， 下 面 的 程序 依赖 于 string 实现 了 comparable 接 
A CRE SS meTSeaVgeg NERS, HIF EII EN Hh 


public class WordList { 
public static void main (String[] args) { 
Set<String> s = new TreeSet<String>(); 


Collections.addAll(s, args); 


System.out.printin(s); 


一 旦 类 实 瑰 了 Comparable 接口 ) Em LR Biz aE (generic 
algorithm) 以 及 依赖 于 该 接口 的 集合 实现 (collection implementation) 
进行 写作 。 你 付出 很 小 的 努力 就 可 以 获得 非 常 强大 的 功能 。 事 实 上 ， 
Java 平 台 类 库 中 的 所 有 值 类 (value classes) 都 实现 了 comparabie 接 


口 。 如 果 你 正在 编写 一 个 值 类 ， 它 具有 非常 明显 的 内 在 排序 关系 ， 比 
如 按 字 母 排 序 、 按 数值 顺序 或 者 按 年 代 顺 序 ， 那 你 束 应 该 坚决 著 虑 实 
现 这 个 接口 : 


public interface Comparable <T> { 


int ompareTo (T t) ; 


compareTo 方法 的 通用 约定 与 equals 方法 的 相似 : 


将 这 个 对 象 与 指定 的 对 象 进 行 比较 。 当 该 对 象 小 于 、 等 于 或 大 于 指定 
对 和 象 的 时 候 ， 分 别 返 回 一 个 负 整 数 、 零 或 者 正 整 数 。 如 采 由 于 指定 对 
象 的 类 型 而 无 法 与 该 对 象 进行 比较 ， 则 抛 出 ciasscastexception FEA ° 


在 下 面 的 说 明 中 ， 符 号 so (RAR) 表示 数学 中 的 signum EBX, 
eee (expression) 的 值 为 负 值 、 零 和 正 值 ， 分 别 返回 -1、0 
或 1 。 


实现 者 必须 确保 所 有 的 x 和 都 满足 sgn(x.compareTo(y) == 
sgn(y.compareTo(x))) 9 (这 也 暗示 着 ， 当 且 仅 当 y.compareTo(x) 抛 出 
异常 时 ， x. compareTo(y) 才 必 须 抛 出 异常 。 o ) 

实现 者 还 必 须 确 保 这 个 比较 关系 是 可 传说 BAN: x.compareTo(y) > 0 && 
y.compareTo(z) > © a" x.compareTo(z) > 0 Š 

最 后 ， 实 现 者 必须 确保 x.comparero(y) == 0 上 暗示 着 所 有 的 z HBW 
KE sgn(x.compareTo(z)) == sgn(y.compareTo(z) ) 9 

e 强烈 建议 (x.compareTo(y) == 0) == (x.equals(y)) ， 但 这 并 非 绝 对 必 
要 。 一 般 说 来 ， 任 何 实现 了 comparable ROAR, Are Sixt 
条 件 ， 都 应 该 明确 予以 说 明 。 推 存 使 用 这 样 的 说 法 : “注意 ， 该 类 
具有 内 在 的 排序 功能 ， 但 是 与 equals 不 一 致 。” 


千 万 不 要 被 上 述 约定 中 的 数学 天 系 所 迷惑 。 如 同 equals 约定 ( 见 

条 ) 一 样 ， comparer。 约定 并 没有 它 看 起 来 的 那么 复杂 。 
部 ， 任何 合理 的 顺序 关系 都 可 以 满足 conmparere 约定 。 与 equals 不 同 
的 是 ， 在 跨越 不 同类 的 时 候 ， comparer。 可 以 不 做 比较 : 如 果 两 个 被 
比较 的 对 象 引 用 不 同类 的 对 象 ， CompareTo 可 以 抛 出 ClassCastException 


异常 。 通 常 ， 这 正 是 compareto 在 这 种 情况 下 应 该 做 的 事情 ， 如 果 类 
设置 了 正确 的 参数 ， 这 也 正 是 它 所 要 做 的 事情 。 虽 然 以 上 约定 并 没有 
把 跨 类 之 间 的 比较 排除 在 外 ， 但 是 从 Java 1.6 发 行 版 本 开始 ，Java 平 台 
类 库 中 束 没 有 哪个 类 有 文 持 这 种 特性 了 。 


E 好 像 违反 了 hashcode 约定 的 类 会 破坏 其 他 依赖 于 散 列 做 法 的 类 一 
样 ， 违 反 compareto 约定 的 类 也 会 破坏 其 他 依赖 于 比较 关系 的 类 。 依 
赖 于 比较 关系 的 类 包括 有 序 集合 类 TreeSet 和 TreeMap , 以 及 工具 类 
collections 和 Arrays ， 它 们 内 部 包含 有 搜索 和 排序 算法 。 


现在 我 们 来 回顾 一 下 compareTo 约定 中 的 条 球 。 第 一 条 指出 ， AAS 
倒 了 两 个 对 象 引用 之 间 的 比较 方向 ， 残 会 发 生 下 面 的 情况 : WRR 
个 对 象 小 于 第 二 个 对 象 ， 则 第 二 个 对 象 一 定 大 于 第 一 个 对 象 ， 如 果 第 
一 个 对 象 等 于 第 二 个 对 象 ， 则 第 二 个 对 象 一 定 等 于 第 一 个 对 象 ， 如 果 
第 一 个 对 象 大 于 第 二 个 对 象 ， 则 第 二 个 对 象 一 定 小 于 第 一 个 对 象 。 第 
条 指出 ， 如 果 一 个 对 象 大 于 第 二 个 对 象 ， 并 且 第 二 个 对 象 又 大 于 第 
三 个 对 象 那么 第 一 个 对 象 一 定 大 于 第 三 个 对 象 。 最 后 一 条 指出 ， 在 
ee 的 所 有 对 象 ， 它 HEA 的 对 象 做 比较 时 一 定 会 产生 


这 三 个 条 款 的 一 个 直接 结果 是 ， 由 compareTo 方法 施加 的 等 同性 测试 
(equality set) ， 也 一 定 遵守 相同 于 equals 约定 所 施加 的 限制 条 件 : 
和 目 反 性 、 对 称 性 和 传递 性 。 因 此 ， 下 面 的 告 诚 也 同样 试用 : 无 法 在 用 
新 的 值 组 件 扩展 可 实例 化 的 类 时 ， 同 时 保持 comparero 约定 ， 除 非 愿 
意 放弃 面向 对 象 的 抽象 优势 〈 见 第 8 条 ) 。 针 对 equals 的 权益 之 计 也 
同样 适用 于 compareTo 方法 。 如 果 你 想 为 一 个 实现 了 Comparable 接口 的 
类 增加 值 组 件 ， 请 不 要 扩展 这 个 类 ; 而 是 要 编写 一 个 不 相关 的 类 ， 其 
中 包含 第 一 个 类 的 一 个 实例 。 然 后 提供 一 个 “视图 (view) "方法 返回 
这 个 实例 。 这 样 既 可 以 让 你 目 由 地 在 第 二 个 类 上 实现 compareto A 
法 ， 同 时 也 允许 它 的 客户 端 在 必要 的 时 候 ， 把 第 二 个 类 的 实例 视 同 第 

一 个 类 的 实例 。 


compareto 约定 的 最 后 一 段 是 一 个 强烈 的 建议 ， 而 不 是 真正 的 规则 ， 只 
是 说 明了 compareto 方法 施加 的 等 同性 测试 ， 在 通常 情况 下 应 该 返回 
与 equals 方法 同样 的 结果 。 如 采 遵 村 了 这 一 条 ， 那 么 由 compareto 方 
法 所 施加 上 | 上 顺序 关系 就 被 认为 “ S equals = (consistent with equals 
) ”。 如 果 违 反 了 这 条 规则 ， 顺 序 关 系 就 被 认为 与 equais 不 一 致 
(inconsistent with equals oh a 20 如 果 一 个 类 的 compareTo 方法 施加 了 一 


个 与 equas 方法 不 一 致 的 顺序 关系 ， 它 仍然 能 够 正常 工作 ， 但 是 ， 如 

果 一 个 有 序 集 合 (sorted collection) 包含 了 该 类 的 元 素 ， 这 个 集合 就 

可 能 无 法 遵守 相应 结合 接口 ( Collection 、 set 或 Map ) 的 通用 约 

定 。 这 是 因为 ， 对 于 这 些 接口 的 通用 约定 是 按照 equals 方法 来 定义 

的 ， 但 是 有 序 集合 使 用 了 由 compareTo FEM RE equals 方法 所 施加 

o 尽管 出 现 这 种 情况 不 会 造成 灾难 性 的 后 果 ， 但 是 应 该 
Ho 


例如 ， 考虑 BigDecimal 类 ， 它 的 compareTo 方法 与 equals 不 一 致 。 如 
果 你 创建 了 一 个 HashSet 实例 ， # AY new BigDecimal("1.0") 和 new 

Bigdecimal("1.0") ， 这 个 集合 束 将 包含 两 个 元 素 ， 因 为 新 增 到 集合 中 的 

两 个 BigDecimal 实例 ， 通过 equals 方法 来 比较 时 是 不 相等 的 ° 然而， 

如 果 你 使 用 TreeSet 而 不 是 HashSet 来 执行 同样 的 过 程 ， 集合 中 将 只 

包含 一 个 元 素 ， 因 为 这 两 个 Bigvecimal 实例 在 通过 compareto 方法 进行 
比较 时 是 相等 的 。 (详情 请 参阅 Bigvecinal 的 文档 。) 


编写 compareTo 方法 与 编写 equals 方法 非常 相似 ， 但 也 存在 儿 处 重大 
的 差别 . 因为 Comparable 接口 是 参数 化 的 ， 而 且 comparable 方法 是 静 
态 的 类 型 ， 因 此 不 必 进 行 类 型 检查 ， 也 不 必 对 它 的 参数 进行 转型 。 如 
果 参 数 的 类 型 不 合适 ， 这 个 调用 甚至 无 法 编译 。 如 果 参 数 为 null ， 
这 个 调用 应 该 抛 出 Nullpointerexception 异常 ， 并 且 一 旦 该 方法 试图 访问 
它 的 成 员 时 残 应 该 抛 出 。 


compareto 方法 中 域 的 比较 是 有 顺序 的 比较 ， 而 不 是 等 同性 的 比较 。 比 
较 对 象 引 用 域 可 以 是 递归 地 调用 comparer。 方 法 来 实现 。 如 果 一 个 域 
并 没有 实现 comparabie 接口 ， 或 者 你 需要 使 用 一 个 非 标准 的 排序 关 
BR, wo Ay DAE AN eb Comparator 来 代替 ° 或 者 编写 自 己 的 

Comparator , 或 者 使 用 已 有 的 Comparator , 譬如 针对 第 8 条 中 

CaseInsensitiveString 类 的 这 个 CompareTo 方法 使 用 a 已 有 的 


Comparator : 


public final class CaseInsensitiveString 


implements Comparable < CaseInsensitiveString > { 


public int compareTo (CaseInsensitiveString cis) { 


return String.CASE_INSENSITIVE_ORDER.compare(s, cis.s); 


. // Remainder omitted 


注意 CaseInsensitiveString 类 实现 了 Comparable<CaseInsensitiveString> $2 

O 2 由 此 可 见 ， CaseInsensitiveString 引用 只 能 与 其 他 的 
Comparable<CaseInsensitiveString> 引用 进行 比较 a 在 声 明 类 去 实现 
Comparable 接口 时 ， 这 是 利用 的 模式 z 还 要 注意 compareTo 方法 的 参数 
是 CaseInsensitiveString , 而 不 是 Object , AECA 明 所 要 求 
的 。 


比较 整数 型 基本 类 型 的 域 ， 可 以 使 用 关系 操作 符 < 和 > 。 例 如 ， 浮 
点 域 用 Double.compare 或 者 Float.compare , 而 不 用 关系 操作 符 ， 当 应 用 
到 浮 点 值 时 ， 它 们 没有 遵守 comparer。 的 通用 约定 。 对 于 数组 ， 则 要 
把 这 些 指导 原则 应 用 到 每 个 元 素 上 。 


如 有 果 一 个 类 有 多 个 关键 域 ， 那 么 ， 按 照 什么 样 的 顺序 来 比较 这 些 域 是 
非常 天 键 的 。 你 必须 从 最 关键 的 域 开 始 ， 逐 步 进 行 到 所 有 的 重要 域 。 
如 有 果 某 个 域 的 比较 产生 了 非 零 的 结果 〈 零 代表 相等 ) ， 则 整个 比较 操 
作 结 束 ， 并 返回 该 结果 。 如 采 最 关键 的 域 是 相等 的 ， 则 进一步 比较 次 
最 关键 的 域 ， 以 此 类 推 。 如 果 所 有 的 域 都 是 相等 的 ， 则 对 象 束 是 相等 
AN, FREF o 下 面 通过 第 9 条 中 的 PhoneNumber 类 的 compareTo 方法 来 
说 明 这 种 方法 : 


public int compareTo (PhoneNumber pn) { 


// Compare area codes 


if (areaCode < pn.areaCode) 


return - 1; 


if (areaCode > pn.areaCode) 


return 1; 
// Area codes are equal, compare prefixes 
if (prefix < pn.prefix) 

return - 1; 
if (prefix > pn.prefix) 


return 1; 


// Area codes and prefixes are equal, compare line numbers 
if (lineNumber < pn.1lineNumber ) 

return - 1 ; 
if (lineNumber > pn.1lineNumber ) 


return 1; 


return ©; // All fields are equal 


PAATI AT, 但 它 还 可 以 进行 改进 ° 回想 一 下 ， compareTo 方 
法 的 约定 并 没有 指定 返回 值 的 大 小 (magnitude) ， 而 只 是 指定 了 返回 
~ 。 你 可 以 利用 这 一 点 来 简化 代码 ， 或 许 还 能 提高 它 的 运行 速 
R: 


public int compareTo (PhoneNumber pn) { 
// Compare area codes 
int areaCodeDiff = areaCode - pn.areaCode; 
if (areaCodeDiff != 0 ) 


return areaCodeDiff; 


// Area codes are equal, compare prefixes 
int prefixDiff = prefix - pn.prefix; 
if (prefixDiff != © ) 


return prefixDiff; 


// Area codes and prefixes are equal, compare line numbers 


return lineNumber - pn.lineNumber; 


这 项 技巧 在 这 里 能 够 工作 得 很 好 ， 但 是 用 起 来 要 非常 小 心 。 除 非 你 确 
信 相 天 的 域 不 会 为 负 值 ， 或 者 更 一 般 的 情况 .最 小 和 最 大 的 可 能 域 值 
LENTES incer. max vae ($2^{23}-1$)， 否 则 就 不 要 使 用 这 种 
方法 。 这 项 技巧 有 时 不 能 正常 工作 的 原因 在 于 ， 一 个 有 符号 的 32 位 的 
整数 还 没有 大 道 足 以 表达 任意 两 个 32 位 整数 的 差 。 如 果 i 是 一 个 很 
大 的 正 整 数 ( int 类 型 ) ， 而 j 是 一 个 很 大 的 负 整 数 ( int 类 
型 ) ， 那 么 a-p 将 会 洲 出 ， 并 返回 一 个 负 值 。 这 样 就 使 得 
compareTo 方法 将 对 某 些 参数 返回 错误 的 结 š 违反 了 compareTo 约定 


的 第 一 条 和 人 第 二 条 。 这 不 是 一 个 纯粹 的 理论 问题 : 它 已 经 在 实际 的 系 
统 中 导致 了 失败 ， 这 些 失 败 可 能 非常 难以 调试 ， 因 为 这 样 的 compareto 
方法 对 大 多 数 的 输入 值 都 能 正常 工作 。 


第 4 章 类 和 接口 


类 和 接口 是 Java 程 序 设计 语言 的 核心 ， 它 们 也 是 Java 语 言 的 基本 抽象 
单元 。Java 语 言 提供 了 许多 强大 的 基本 元 素 ， 供 程序 员 用 来 设计 类 和 
接口 。 本 章 阐 述 的 一 些 指 导 原 则 ， 则 可 以 帮助 你 更 好 地 利用 这 些 元 
素 ， 设 计 出 更 加 有 用 、 健 壮 和 有 灵活 的 类 和 接口 。 


aii 使 类 的 成 员 的 可 访问 性 最 小 


要 区 别 设计 良好 的 模块 与 设计 不 好 的 模块 ， 最 重要 的 因素 在 于 ， 这 个 
模块 对 于 外 部 的 其 他 模块 而 言 ， 是 否 隐藏 其 内 部 数据 和 其 他 实现 细 
广 。 设 计 民 好 的 模块 会 隐藏 所 有 的 实现 细 广 ， 把 它 的 API 和 它 的 实现 
清晰 地 隔离 开 来 。 然 后 ， 模 块 之 间 只 通过 它们 的 API 进 行 通 信 ， 一 个 
模块 不 需要 知道 其 他 模块 的 内 部 工作 情况 。 这 个 概念 被 称 为 A a 

(information hiding) 或 FX (encapsulation) ， 是 软件 设计 的 基本 
原则 之 一 [Parnas72]。 


信息 隐藏 之 所 以 非常 重要 有 许多 原因 ， 其 中 大 多 数理 由 都 源 于 这 样 一 
个 事实 : 它 可 以 有 效 地 解除 组 成 系统 的 各 模块 之 间 的 糊 合 关系 ， 使 得 
这 些 模块 可 以 独立 地 开发 、 测 试 、 优 化 、 使 用 、 理 解 和 修改 。 这 样 可 
以 加 快 系统 开发 的 速度 ， 因 为 这 些 模块 可 以 并 行 开 发 。 它 也 减轻 了 维 
护 的 负担 ， 因 为 程序 员 可 以 更 快 地 理解 这 些 模块 ， 并 且 在 调试 它们 的 
时 候 可 以 不 影响 其 他 的 模块 。 虽 然 信息 隐藏 本 身 无 论 是 对 内 还 是 对 

外 ， 都 不 会 市 来 更 好 的 性 能 ， 但 是 它 可 以 有 效 地 调和 性 能 : 一旦 完成 
一 个 系统 ， 并 通过 剖析 确定 了 哪些 模块 影响 了 系统 的 性 能 〈 见 第 55 

条 ) ， 那 些 模块 机 束 可 以 被 进一步 优化 ， 而 不 会 影响 到 其 他 模块 的 正 
确 性 。 信息 隐藏 提高 了 软件 的 可 重用 性 ， 因 为 模块 之 间 并 不 紧密 相 

连 ， 除 了 开发 这 些 模块 所 使 用 的 环境 之 外 ， 它 们 在 其 他 的 环境 中 往往 
也 很 有 用 。 最 后 ,信息 隐藏 也 降低 了 构建 大 型 系统 的 风险 ， 因 为 即使 
整个 系统 不 可 用 ， 但 是 这 些 独立 的 模块 却 有 可 能 是 可 用 的 。 


Java 程 序 设计 语言 提供 了 许多 机 制 (facility) 来 协助 信息 隐藏 。 IZ /a/ 
FE (access acontrol) 机 制 [JLS，6.6] 决 定 了 类 、 接 口 和 成 员 的 Wiz 
HIE (accessibility) 。 实 体 的 可 访问 性 是 由 该 实体 声明 所 在 的 位 置 ， 
以 及 该 实体 声明 中 所 出 现 的 访问 修饰 符 ( private 、 protected 和 
my cI 
常 关键 的 。 


第 一 规则 很 简单 A ELE ET RAMA GTA A] o Hais 
ie a 与 你 正在 编写 的 软件 的 对 应 功能 相 一致 的 、 尽 可 能 最 小 
J 访问 级 别 。 


对 于 顶层 的 GEREK) 类 和 接口 ， 只 有 两 种 可 能 的 访问 级 别 : EK 
HAKI (package-private) 和 公有 的 (public) 。 如 果 你 用 pubiic 修 
饰 符 声明 了 顶层 类 或 者 接口 ， 那 它 束 是 公有 的 ;否则 ， 它 将 是 包 级 私 
有 的 。 如 采 类 或 者 接口 能 够 被 做 成 包 级 私有 的 ， 它 束 应 该 被 做 成 包 级 
私有 。 通 过 把 类 或 者 接口 做 成 包 级 私有 ， 它 实际 上 成 了 这 个 包 的 实现 
的 一 部 分 ， 而 不 是 该 包 导 出 的 API 的 一 部 分 ， 在 以 后 的 发 行 版 本 中 ， 
可 以 对 它 进 行 修改 、 苦 换 ， 或 者 删除 ， 而 无 需 担 心 会 影响 到 现 有 的 客 
ee ee 
它们 的 兼容 性 。 


如 有 果 一 个 包 级 私有 的 顶层 类 (或 者 接口 ， 只 是 在 某 一 个 类 的 内 部 被 用 
到 ， 就 应 该 考虑 使 它 成 为 唯一 使 用 它 的 那个 类 的 私有 藤 套 类 〈 见 第 22 
R) 。 这 样 可 以 将 它 的 可 访问 范围 从 包 中 的 所 有 类 缩小 到 了 使 用 它 的 
那个 类 。 然 而 ， 降 低 不 必要 公有 类 的 可 访问 性 ， 比 降低 包 级 私有 的 项 
层 类 的 更 重要 得 多 : 因为 公有 类 是 包 的 API 的 一 部 分 ， 而 包 级 私有 的 
顶层 类 则 已 经 是 这 个 包 的 实现 的 一 部 分 。 


对 于 成 员 ( 域 、 方 法 、 髓 套 类 和 骨 套 接口 ， 有 四 种 可 能 的 访问 级 别 ， 
下 面 按照 可 访问 性 的 递增 顺序 罗列 出 来 : 


。 私 有 的 (private) 只 有 在 声明 该 成 员 的 顶层 类 内 部 才 可 以 
访问 这 个 成 员 。 

。 包 级 私有 的 (package-private) 一 一 声明 该 成 员 的 包 内 部 的 任何 
类 都 可 以 访问 这 个 成 员 。 从 技术 上 讲 ， 它 被 称 为 “ GE (default) 
be 如 打 没 有 为 成 员 指定 访问 修饰 符 ， 束 采用 这 个 访问 级 
I| o 


。 受 保护 的 (protected) 一 一 声明 该 成 员 的 子 类 可 以 访问 这 个 成 
A (但 有 一 些 限 制 JLS，6.6.2]) ， 并 且 ， 声 明 该 成 员 的 包 内 部 的 
任何 类 也 可 以 访问 这 个 成 员 。 

。 公 有 的 (public) 一 一 在 任何 地 方 都 可 以 访问 该 成 员 。 


当 你 仔细 地 设计 了 类 的 公有 API 之 后 ， 可 能 觉得 应 该 把 所 有 其 他 的 成 
员 都 变 成 私有 的 。 其 实 ， 只 有 当 同 一 个 包 内 的 男 一 个 类 真正 需要 访问 
一 个 成 员 的 时 候 ， 你 才 应 该 删除 private 修饰 符 ， 使 该 成 员 编程 包 级 
私有 的 。 如 果 你 发 现 自 己 经 常 要 做 这 样 的 的 事情 ， 束 应 该 重新 检查 你 
的 系统 设计 ， 看 看 是 否 另 一 种 分 解 方案 所 得 到 的 类 ， 与 其 他 类 之 间 的 
耦合 度 会 更 小 。 也 束 是 说 ， 私 有 成 员 和 包 级 私有 成 员 都 是 一 个 类 的 实 
现 中 的 一 部 分 ， 一 般 不 会 影响 它 的 导出 的 API。 然 而， 如 果 这 个 类 实 
现 了 Serializable 接口 ( 见 第 74 和 75 条 ) ， 这 些 域 就 有 可 能 会 被 “泄露 
(leak) ”到 导出 的 API 中 。 


对 于 公有 类 的 成 员 ， 当 访问 级 别 从 包 级 私有 编程 保护 级 别 是 ， 会 大 大 
增强 可 访问 性 。 受 保护 的 成 员 时 类 的 导出 的 API 的 一 部 分 ， 必 须 永远 
得 到 支持 。 导 出 的 类 的 受 保护 成 员 也 代表 了 该 类 对 于 某 个 实现 细 市 的 
公开 承诺 〈 见 第 17 条 ) 。 受 保护 的 成 员 应 该 尽量 少 用 。 


有 一 条 规则 限制 了 降低 方法 的 可 访问 性 的 能 力 。 如 果 方 法 覆盖 了 超 类 
中 的 一 个 方法 ， 子 类 中 的 访问 级 别 就 不 允许 低 于 超 类 中 的 访问 级 别 

[JLS，8.4.8.3]。 这样 可 以 确保 任何 可 使 用 超 类 的 实例 的 地 方 也 都 可 以 
使 用 子 类 的 实例 。 如 果 你 违反 了 这 条 规则 ， 那 么 当 你 试图 编译 该 子 类 
的 时 候 ， 编 译 器 就 会 产生 一 条 错误 消息 。 这 条 规则 有 种 特殊 的 情形 : 

如 果 一 个 类 实现 了 一 个 接口 ， 那 么 接口 中 所 有 的 类 方法 在 这 个 类 中 也 
都 必须 被 声明 为 公有 的 。 之 所 以 如 此 ， 是 因为 接口 中 所 有 方法 都 隐 含 
着 公有 访问 级 别 [JLS，9.1.5]。 


为 了 便于 测试 ， 你 可 以 试 着 使 类 、 接 口 或 者 成 员 变 得 更 容易 访问 。 这 

么 做 在 一 定 程度 上 来 说 是 好 的 。 为 了 测试 而 将 一 个 公有 类 的 私有 成 员 

变 成 包 级 私有 的 ， 这 还 可 以 接受 ， 但 是 要 将 访问 级 别提 高 到 超过 它 ， 

这 就 无 法 接受 了 。 换 句 话说 ， 不 能 为 了 测试 ， 而 将 类 、 接 口 或 者 成 员 

变 成 包 的 导出 的 API 的 一 部 分 。 幸 运 的 是 ， 也 没有 必要 这 么 做 ， 因 为 

0 
JIL ° 


NORA BEER AHT 〈 见 第 14 条 ) 。 如 果 域 是 非 tina 的， 或 者 是 
一 个 指 同 可 变 对 象 的 tina 引用 ， 那 么 一 旦 使 这 个 域 成 为 公有 的 ， 束 
放弃 了 对 存储 在 这 个 域 中 的 值 进行 限制 的 能 力 ; 这 意味 着 ， 你 也 放弃 
了 强制 这 个 域 不 可 变 的 能 力 。 同 时 ， 当 这 个 域 被 修改 的 时 候 ， 你 也 失 
去 了 对 它 采 取 任 何 行动 的 能 力 。 因 此 ， BESA PMMA EE 
在 女 全 的 。 即 使 域 定 tina 的 ， 并 且 引 用 不 可 变 对 象 ， 当 把 这 个 域 编 
ee 


同样 的 建议 也 适用 于 静态 域 ， 只 是 有 一 种 例外 情况 。 假 设 稼 量 构成 了 
类 提供 的 整个 抽象 中 的 一 部 分 ， 可 以 通过 公有 的 静态 tina 域 来 暴露 
这 些 币 量 。 按 惯例 ， 这 种 域 的 名 称 由 大 写字 母 组 成 ， 单 词 之 间 用 下 划 
线 隅 开 〈 见 第 56 条 ) 。 很 重要 的 一 点 事 ， 这 些 域 要 么 包含 基本 类 型 的 
值 ， 要 么 包含 指向 不 可 变 对 象 的 引用 〈 见 第 15 条 ) 。 如 果 tina 域 包 
含 可 变 对 象 的 引用 ， 她 便 具有 非 final 域 的 所 有 去 电 。 虽 然 引 用 本 身 
Re 


注意 ， 长 度 非 堆 的 数组 总 是 可 变 的 ， 所 以 ， KAALA HIBP fina 
IAL, A REL PHT TTA, DLE ERAT ° URE 
有 这 样 的 域 或 者 访问 方法 ， 客 户 端 将 能 够 修改 数组 中 的 内 容 。 这 是 安 
全 漏洞 的 一 个 章 见 根源 : 


// Potential security hole! 

public static final Thing[] VALUES = { ... }; 
要 注意 ， 许 多 IDE 会 产生 返回 指向 私有 数组 域 的 引用 的 访问 方法 ， 这 
样 束 会 产生 这 个 问题 。 修 正 这 个 问题 有 两 种 方法 。 可 以 使 公有 数组 变 
成 私有 的 ， 并 增加 一 个 公有 的 不 可 变 列表 : 

private static final Thing[] PRIVATE_VALUES = { ... }; 


public static final List<Thing> VALUES = 


Collections.unmodifiableList(Arrays.asList(PRIVATE_VALUES) ) ; 


男 一 种 方法 是 ， 可 以 使 数组 变 成 私有 的 ， 并 添加 一 个 公有 方法 ， 它 返 
回 私有 数组 的 一 个 备份 : 


private static final Thing[] PRIVATE_VALUES = { ... }; 
public static final Thing[] values() { 


return PRIVATE_VALUES.clone(); 


要 在 这 两 种 方法 之 间 做 出 选择 ， 得 考虑 客户 端 可 能 怎么 处 理 这 个 结 
果 。 哪 种 返回 类 型 会 更 加 方便 ? 哪 种 会 得 到 更 好 的 性 能 ? 


总 而 言 之 ， 你 应 该 始终 尽 可 能 地 降低 可 访问 性 。 你 在 仔细 地 设计 一 个 
最 小 的 公有 API 之 后 ， 应 该 防止 把 任何 散乱 的 类、 接口 和 成 员 变 成 API 
的 一 部 分 。 除 了 公有 静态 nar 域 的 特殊 情形 之 外 ， 公 有 类 都 不 应 该 
包 全 公有 域 。 并 且 要 确保 公有 鹏 态 _amey 城 所 引用 的 对 象 邦 是 不 可 灾 


第 14 条 : 在 公有 类 中 使 用 访问 方法 而 
非 公有 域 


有 时 候 ， 可 能 会 编写 一 些 退 化 类 (degenerate classes) ， 没 有 什么 作 
用 ， 只 是 用 来 集中 实例 域 : 


)egenerate classes like this should not be public! 


class Point { 


public double x; 


public double y; 


由 于 这 种 类 的 数据 是 可 以 被 直接 访问 的 ， 这 些 类 没有 提供 封装 

(ecapsulation) 的 功能 ( 见 第 13 条 ) 。 如 果 不 改变 API， 就 无 法 改变 
它 的 数据 表示 法 ， 也 无 法 强加 任何 约束 条 件 ; 当 域 被 访问 的 时 候 ， 无 
法 采取 任何 辅助 的 行动 。 坚持 面 品 对 象 程序 设 计 的 程序 猿 对 这 种 类 深 
恶 痛 绝 ， 认 为 应 该 用 包含 私有 域 和 公有 访问 方法 ( getter ) 的 类 代 
炊 。 对 于 可 变 的 类 来 说 ， 应 该 用 包含 私有 域 和 公有 设 值 方法 ( setter 


) 的 类 代替 : 
// Encapsulation of data by accessor methods and mutators 
class Point { 
private double x; 
private double y; 
public Point ( double x, double y) { 
this Wee 


this .y = y; 


public double getX () { return x; } 


public double getY () { return y; } 


public void setX ( double x) { this .x = x; } 


public void setY ( double y) { this .y = y; } 
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的 数据 域 ， 要 想 在 将 来 改变 其 内 部 表示 法 是 不 可 能 的 ， 因 为 公有 类 的 
客户 端 代码 已 经 遍布 各 处 了 。 


然而 ， MWRAREORELAN, MAEhAWRER, ABR CHE 
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抽象 。 这 种 方法 比 访问 方法 的 做 法 更 不 会 产生 视觉 宴 乱 ， 无 论 实在 类 
定义 中 ， 还 是 在 使 用 类 的 客户 端 代 码 中 。 虽 然 客户 端 代码 与 该 类 的 内 
部 表示 法 紧密 相连 ， 但 是 这 些 代码 被 完 定 在 包含 该 类 的 包 中 。 如 有 必 
要 ， 不 改变 包 之 外 的 任何 代码 而 只 改变 内 部 数据 表示 法 也 十 可 以 的 。 

在 私有 藤 套 类 的 情况 下 ， 改 变 的 作用 范围 被 进一步 限制 在 外 围 类 中 。 


Java 平 台 类 库 中 有 几 个 类 违反 了 “公有 类 不 应 该 直接 暴露 数据 域 " 的 告 
TR 9 显著 的 例子 包括 java.awt 包 中 的 Point 和 Dimension 类 o 它们 是 
不 值得 效仿 的 例子 ， 相 反 ， 这 些 类 应 该 被 当做 反面 的 警告 示例 。 正 如 
第 55 条 中 所 讲述 的 ， 决 定 暴露 pinension 类 的 内 部 数据 造成 了 严重 的 
性 能 问题 ， 而 且 ， 这 个 问题 至 今 依然 存在 。 


让 公有 类 直接 雄 露 域 虽然 从 来 都 不 是 种 好 办 法 ， 但 是 如 有 果 域 是 不 可 变 
的 ， 这 种 做 法 的 危害 束 比 较 小 一 些 。 如 果 不 改变 类 的 API， 束 无 法 改 
变 这 种 类 的 表示 法 ， 当 域 税 读 取 的 时 候 ， 你 也 无 法 采取 辅助 的 行动 ， 
r 。 例 如， 这 个 类 确保 了 每 个 实例 都 表示 一 个 有 
效 的 时 间 : 


// Public class with exposed immutable fields - questionable 


public final class Time { 


private static final int HOURS_PER_DAT = 24; 


private static final int MINUTES PER HOUR = 60 ; 


public final int hour; 


public final int minute; 


public Time ( int hour, int minute) { 


if (hour < © || hour >= HOURS_PER_DAT) 

throw new IllegalArgumentException( "Hour: " + hour); 
if (minute < © || minute >= MINUTES _PER_HOUR) 

throw new IllegalArgumentException( "Min: " + minute); 


this .hour = hour; 


this .minute = minute; 


// Remainder omitted 
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第 15 条 : 使 可 变性 最 小 化 


不 可 变 类 只 是 其 实例 不 能 被 修改 的 类 。 每 个 实例 中 包含 的 所 有 信息 都 
必须 在 创建 该 实例 的 时 候 就 提供 ， 并 在 对 象 的 整个 生命 周期 

(lifetime) 内 固定 不 变 。Java 平 台 类 库 中 包含 许多 不 可 变 的 类 ， 其 中 
有 String ` 基本 类 型 的 包装 类 ~ BigInteger 和 BigDecimal ° 存在 不 可 
变 的 类 有 许多 理由 : 不 可 变 的 类 比 可 变 类 更 加 易于 设计 、 实 现 和 使 
用 。 它 们 不 容易 出 错 ， 且 更 加 安全 。 


为 了 使 类 成 为 不 可 变 ， 要 遵循 下 面 五 条 规则 : 


1. 不 要 提供 任何 会 修改 对 象 状 态 的 方法 “(也 成 为 mutator) 。[ 注 1 
2. 保证 类 不 会 被 扩展 。 这 样 可 以 防止 粗心 或 者 恶意 的 子 类 假装 对 象 
的 状态 已 经 改变 ， 从 而 破坏 该 类 的 不 可 变 行 为 。 为 了 防止 子 类 
化 ， 一 般 做 法 是 使 这 个 类 成 为 tinat 的 ， 但 是 后 面 我 们 还 会 讨论 

到 其 他 的 做 法 。 

3. 使 所 有 的 域 都 是 tina 的 。 通 过 系统 的 强制 方式 ， 这 可 以 清楚 地 
表明 你 的 意图 。 而 且 ， 如 果 一 个 指 问 新 创建 实例 的 引用 在 缺乏 同 
步 机 制 的 情况 下 ， 从 一 个 线程 被 传递 到 男 一 个 线程 ， 就 必需 确保 
正确 的 行为 ， 正 如 内存 模型 (memory model) 中 所 述 [JLS， 
17.5; Goetzo6 16] ° 

4. 使 所 有 的 域 都 成 为 私有 的 。 这 样 可 以 防止 客户 端 获得 访问 被 域 引 
用 的 可 变 对 象 的 权限 ， 并 防止 客户 端 直接 修改 这 些 对 象 。 虽 然 从 
技术 上 讲 ， 人 允许 不 可 变 的 类 具有 公有 的 final 域 ， 只 要 这 些 域 包 
含 基本 类 型 的 值 或 者 指 问 不 可 变 对 象 的 引用 ， 但 是 不 建议 这 样 
Rs 

见 第 13 条 ) 。 

5. 确保 对 于 任何 可 变 组 件 的 互 斥 访问 。 如 果 类 具有 指向 可 变 对 象 的 
域 ， 则 必须 确保 该 类 的 客户 端 无 法 获得 指 癌 这 些 对 象 的 3 引用。 并 
且 ， 永 远 不 要 用 客户 端 提 供 的 对 象 引 用 来 初始 化 这 样 的 域 ， 也 不 
要 从 任何 访问 方法 (accessor) 中 返回 该 对 象 引 用 。 在 构造 器 、 访 
问 方 法 和 readobject TE ( 见 第 76 条 ) 中 请 使 用 ERIPLEFE IA 

(defensive copy) 技术 〈 见 第 39 条 ) 。 


前 面条 目 中 的 许多 例子 都 是 不 可 变 的 ， 其 中 一 个 例子 是 第 9 条 中 的 
Phonenumber ， 它 针对 每 个 属性 都 有 访问 方法 (accessor) ， 但 是 没有 对 
应 的 设 值 方法 (mutator) 。 下 面 是 个 稍微 复杂 一 点 的 例子 : 


public final class Complex { 


private final double re; 


private final double im; 


public Complex ( double re, double im) { 


this .re = re; 


this .im = im; 


// Accessors with no corresponding mutators 


public double realPart () { return re; } 


public double imaginaryPart () { return im; } 


public Complex add (Complex c) { 


return new Complex(re + c.re, im + c.im); 


public Complex subtract (Complex c) { 


return new Complex(re - c.re, im - c.im); 


public Complex multiply (Complex c) { 


return new Complex(re * c.re - im * c.im, 


re * c.re + im * c.im); 


public Complex divide (Complex c) { 


double tmp = c.re * c.re + c.im * c.im; 


return new Complex((re * c.re + im * c.im) / tmp, 


(im * c.re - re * c.im) / tmp); 


@Override public boolean equals (Object o) { 


if (0 == this ) 


return true ; 


if (!(0 instanceof Complex) ) 


return false ; 


Complex c = (Complex) o; 


// See page 43 to find out why we use compare instead of == 


return Double.compare(re, c.re) == 0 && 


Double.compare(im, c.im) == 0 ; 


@Override public int hashCode () { 


int result = 17 + hashDouble(re); 


result = 31 * result + hashDouble(im); 


return result; 


private int hashDouble ( double val) { 


long longBits = Double.doubleToLongBits(re); 


return ( int ) (longBits ^ (longBits >>> 32 )); 


@Override public String toString () { 


return oa + re + " + W + im + art) i 7 


这 个 类 表示 一 个 BR (complex number ， 具 有 实 部 和 虚 部 ) 。 除 了 
标准 的 opject 方法 之 外 ， 它 还 提供 了 针对 实 部 和 虚 部 的 访问 方法 ， 以 
及 4 种 基本 的 算数 运算 : 加 法 、 减 法、 乘法 和 除法 。 注 意 这 些 算数 运算 
是 如 何 创 建 并 返回 新 的 compres 实例 ， 而 不 是 修改 这 个 实例 。 大 多 数 
重要 的 不 可 变 类 都 使 用 了 这 种 模式 。 它 被 称 为 YACHT (functional) 
做 法 ， 因 为 这 些 方法 返回 了 一 个 函数 的 结果 ， 这 些 函 数 对 操作 数 进 行 
运算 但 并 不 修改 它 。 与 之 相对 应 的 更 常见 的 是 AI (procedural) 
或 者 MECHI (imperative) 做 法 ， 使 用 这 些 方式 时 ， 将 一 个 过 程 作 
用 在 它们 的 操作 数 上 ， 对 导致 它 的 状态 发 生 改 变 。 


如 有 果 你 对 函数 方式 的 做 法 还 不 太 熟 悉 ， 可 能 会 觉得 它 显得 不 太 日 然 ， 

(Lee COR TANASE, RAVES © RADAR ° AAT 
变 对 象 可 以 只 有 一 种 状态 ， 即 被 创建 是 的 状态 。 如 采 你 能 够 确保 所 有 
的 构造 右 痢 建立 了 这 个 类 的 约束 关系 ， 束 可 以 确保 这 些 约束 关系 在 整 
个 生命 周期 内 永远 不 再 发 生变 化 你 和 使 用 这 个 类 的 程序 员 都 无 需 再 做 
额外 的 工作 来 维护 这 些 约束 天 系 。 另 一 方面 ， 可 变 的 对 象 可 以 有 任意 
复杂 的 状态 空间 。 如 果 文 档 中 没有 对 mnutator 方 法 所 执行 的 状态 转换 提 
供 精确 的 摘 述 ， 要 可 知 地 使 用 一 个 可 变 类 有 是 非常 困难 的 ， 甚 至 是 不 可 


能 的 。 
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访问 这 样 的 对 象 时 ， 它 们 不 会 遭 到 了 破坏。 这 无 疑 是 获得 线程 安全 最 容 
易 的 办 法 。 实 际 上 ， 没 有 任何 线程 会 注意 到 其 他 线程 对 于 不 可 变 对 象 
的 影响 。 所 以 ， NAPE RA UR A RS © PZR A 
用 这 种 人 优势， 发 励 客户 端 尽 可 能 地 重用 现 有 的 实例 。 要 做 到 这 一 点 ， 

一 个 很 简单 的 办 法 束 是 ， 对 于 频繁 用 到 的 值 ， 为 它们 提供 公有 的 静态 
final 音量 。 例 如 ， Complex 类 有 可 能 会 提供 下 面 的 常量: 


public static final Complex ZERO = new Complex( ©, 0); 


public static final Complex ONE = new Complex( 1, 0); 


public static final Complex I = new Complex( 0, 1); 
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BIR) ， 它 们 把 频繁 被 请 求 的 实例 缓存 起 来 ， 从 而 当 现 有 实例 可 以 符 
合 请 求 的 时 候 ， 就 不 必 创 建新 的 实例 。 所 有 基本 类 型 的 包装 类 和 
BigInteger 都 有 这 样 的 静态 工厂 。 使 用 这 样 的 静态 工厂 也 使 得 客户 端 
之 间 可 以 共享 现 有 的 实例 ， 而 不 用 创建 新 的 实例 ， 从 而 降低 内 存 占用 
和 垃圾 回收 的 成 本 。 在 设计 新 的 类 时 ， 选 择 用 静态 工厂 代替 公有 的 构 
造 磺 可 以 让 你 以 后 有 添加 缓存 的 灵活 性 ， 而 不 必 影 响 客户 端 。 


“不 可 变 对 象 可 以 被 目 由 地 共享 ”导致 的 结果 是 ， 永 远 也 不 需要 进行 你 
PEHEN 〈 见 第 39 条 ) 。 实 际 上 ， 你 根本 无 需 做 任何 拷贝 ， 因 为 这 些 
拷贝 始终 等 于 原始 的 对 象 。 因此， 你 不 需要 ， 也 不 应 该 为 不 可 变 的 类 
提供 cioe DERE FAM AF (copy constructor ， 见 第 11 条 ) ° 
这 一 点 在 Java 平 台 的 早起 并 不 好 理解 ， 所 以 string 类 仍然 具有 拷贝 构 
造 器 ， 但 是 应 该 尽量 少 用 它 〈 见 第 5 条 ) ° 
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piginteger 类 内 部 使 用 了 符号 数值 表示 法 。 符 号 用 一 个 int 类 型 的 值 
HRD, 数值 则 用 一 个 int 数组 表示 。 negate 方法 产生 一 个 新 的 
piginteger ， 其 中 数值 是 一 样 的， 符号 则 是 相反 的 。 它 并 不 需要 拷贝 
数组 ;新建 的 的 Bigrmteger 也 指向 原始 实例 中 的 同一 个 内 部 数组 。 


AS TEXT RAF OT REE ST AKEBWPIE (building blocks) ， 无 论 是 
可 变 的 还 是 不 可 变 的 对 象 。 如 果 知 道 一 个 复杂 对 象 内 部 的 组 件 对 象 不 
会 改变 ， 要 维护 它 的 不 变性 约束 是 比较 容易 的 。 这 条 原则 的 一 种 特例 
在 于 ， 不 可 变 对 象 构成 了 大 量 的 映射 键 (map key) 和 集合 元 素 (set 
element) ; 一 旦 不 可 变 对 象 进 入 到 映射 (map) 或 者 集合 (set) P, 
cee hee 但 是 也 不 用 担心 它们 的 值 
Z LIL ° 
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和 条。 创建 这 种 对 象 的 代价 可 能 很 高 ， 特 别 是 对 于 大 型 对 象 的 情形 。 例 
如 ， 假 设 你 有 一 个 上 百 万 位 的 sigInteger ， 想 要 改变 它 的 低位 : 


BigInteger moby = ...; 


moby = moby.flipBit( © ); 


flipBit 方法 创建 了 一 个 新 的 wiginteger 实例 ， 也 有 上 百 万 位 长 ， 它 与 
原来 的 对 象 只 差 一 位 不 同 。 这 项 操作 所 消耗 的 时 间 和 空间 与 
BigInteger 的 成 正比 。 我 们 拿 它 与 java.util.BitSet ETT EKER ° Fy 
BigInteger 类 似 ， BitSet 代表 -个 任意 长 度 的 位 序列 ， 但 是 与 
BigInteger 不 同 的 是 ， BitSet 是 可 变 的 。 BitSet 类 提供 了 一 个 方 
(constant time) 内 改变 此 “ 百 万 位 ”实例 中 单个 位 


如 果 你 执行 一 个 多 步骤 的 操作 ， 并 且 每 个 步 又 都 会 产生 一 个 新 的 对 

象 ， 除 了 最 后 的 结果 之 外 其 他 的 对 象 最 终 都 会 被 于 弄 ， 此 时 性 能 问题 
束 会 显露 出 米 。 处 理 这 种 问题 有 两 种 办 法 。 第 一 种 办 法 ， 先 猜测 一 下 
会 经 名 用 到 哪些 多 步骤 的 操作 ， 然 后 将 它们 作为 基本 类 型 提供 。 如 果 
某 个 多 步骤 操作 已 经 作为 基本 类 型 提供 ， 不 可 变 的 类 天 可 以 不 必 在 每 
个 步骤 单独 创建 一 个 对 象 。 不 可 变 的 类 在 内 部 可 以 更 加 灵 话 。 例 如 ， 

BigInteger 有 一 个 包 级 私有 的 可 变 “ 配 套 类 (companing class) ss 它 的 
用 途 是 加 速 诸 如 “ 模 指 数 (modular exponentiation) ”这 样 的 多 步骤 操 
作 。 由 于 前 面 提 到 的 诸多 原因 ， 使 用 可 变 的 配套 类 比 使 用 Bigrnteger 

要 困难 得 多 ， 但 笠 运 的 是 ， 你 并 不 需要 这 样 做 。 因 为 Biginteger 的 实 
现 者 已 经 蔡 你 完成 了 所 有 困难 的 工作 。 


如 果 能 够 精确 地 预测 出 客户 端 将 要 在 不 可 变 的 类 上 执行 哪些 复 洒 的 多 
阶段 操作 ， 这 种 包 级 私有 的 可 变 配 套 类 惑 可 以 工作 得 很 好 。 如 果 无 法 
预测 ， 最 好 的 办 法 是 提供 一 个 AA 可 变 配套 类 。 在 Java 平 台 类 库 
中 ， 这 种 方法 的 主要 例子 是 strin 类 ， 它 的 可 变 配 套 类 是 
StringBuilder (和 基本 上 已 经 废弃 的 StringBuffer ) 。 可 以 这 样 认 为 ， 
在 特定 的 环境 下 ， 相对 于 BigInteger Me, BitSet 同样 扮演 了 可 变 配 
套 类 的 角色 。 


现在 你 已 经 知道 了 如 何 构建 不 可 变 的 类 ， 并 且 了 解 了 不 可 变性 的 优点 
和 缺点 ， 现 在 我 们 来 讨论 其 他 的 一 些 设计 方案 。 前 面 提 到 过 ， 为 了 确 
保 不 可 变性 ， 类 绝对 不 允许 目 身 被 子 类 化 ， 除 了 “使 类 成 为 tina 

的 ”这 种 方法 之 外 ， 还 有 一 种 更 加 灵活 的 办 法 也 可 以 做 到 这 一 点 。 让 不 
可 变 的 类 变 成 final 的 男 一 种 办 法 束 是 ， 让 类 的 所 有 构造 器 都 变 成 私 


有 的 或 者 包 级 私有 的 ， 并 添加 公有 的 EL (static factory) 来 代 
BOA Raia 〈 见 第 1 条 ) 。 


Po 下 面 以 conplex 为 例 ， 看 看 如 何 使 用 这 种 方 
YE: 


// Immutable class with static factories instead of constructors 
public class Complex { 
private final double re; 


private final double im; 
private Complex ( double re, double im) { 


this .re = re; 


this .im = im; 


public static Complex valueOf ( double re, double im) { 


return new Complex(re, im); 


// Remainder unchanged 


EORISMATIZH Di, (HEAR ERECT ° Eas, Al 
为 它 允 许 使 用 多 个 包 级 私有 的 实习 类 。 对 于 处 在 它 的 包 外 部 的 客户 端 
而 言 ， 不 可 变 类 实际 上 是 final 的 ， 因 为 不 可 能 把 来 目 另 一 个 包 的 
类 、 缺 少 公 有 的 活 受 保护 的 构造 器 的 类 进行 扩展 。 除 了 人 允许 多 个 实现 
类 的 灵活 性 之 外 ， 这 种 方法 还 使 得 有 可 能 通过 改善 静态 工厂 的 对 和 象 绥 
存 能 力 ， 在 后 续 的 发 行 版 本 中 改进 该 类 的 性 能 。 


静态 工厂 与 构造 器 想必 有 具有 许多 其 他 的 优势 ， 正 如 在 第 1 条 中 所 讨论 
的 。 例 如 ， 假 设 你 布 望 提供 一 种 “基于 极 坐标 创建 复数 ”的 方式 。 如 果 
使 用 构造 右 来 实现 这 样 的 功能 ， 可 能 会 使 得 这 个 类 很 零乱 ， 因 为 这 样 
的 构造 器 与 已 用 的 构造 器 Complex(double, double) 具有 相同 的 签名 2 通 
过 静态 工厂 ， 这 很 容易 做 到 。 只 需 添加 第 二 个 静态 工厂 ， 并 且 工 厂 的 
名 字 消 楚 地 表明 了 它 的 功能 即 可 : 


public static Complex valueOfPolar ( double r, double theta) { 
return new Complex(r * Math.cos(theta), 


r * Math.sin(theta)); 


当 pigtnteger 和 Bigpecimal 刚 被 编写 出 来 的 时 候 ， 对 于 “不 可 变 的 类 必 
须 为 final 的 ”还 没有 得 到 广泛 地 理解 ， 所 以 它们 的 所 有 方法 都 可 能 
会 被 覆盖 。 遗 慨 的 是 ， 为 了 保持 问 后 兼容 ， 这 个 问题 一 直 无 法 得 以 修 
正 。 如 果 你 在 编写 一 个 类 ， 它 的 安全 性 依赖 于 《来 目 不 可 信和 客户 端 
的 ) BigInteger 或 者 BigDecimal 参数 的 不 可 变性 ， WD DUH T 今 查 ， 
以 确定 这 个 参数 是 否 为 "真正 的 ”Bigrnteger 或 者 Bigpecinal ， 而 不 是 
不 可 信任 子 类 的 实例 。 如 果 是 后 者 的 话 ， 就 必须 在 假设 它 可 能 是 可 变 
的 前 提 下 对 它 进 行 保护 性 拷贝 ( 见 第 39 条 ) : 


public static BigInteger safeInstance (BigInteger val) { 


if (val.getClass() != BigInteger.calss) 


return new BigInteger(val.toByteArray()); 


return val; 


本 条 目 开 头 初 关于 不 可 变 类 的 诸多 规则 指出 ， 没 有 方法 会 修改 对 象 ， 

并 且 它 的 所 有 域 都 必须 是 final 的 。 实 际 上 ， 这 些 规则 比 真正 的 要 求 
更 强硬 了 一 点 ， 为 了 提供 性 能 可 以 有 所 放松 。 事 实 上 应 该 是 这 样 : 没 
有 一 个 方法 能 够 对 对 象 的 状态 产生 SAB ATH (externally visible) 的 改 
变 。 然 而 ， 许 多 不 可 变 的 类 拥有 一 个 或 者 多 个 非 final 的 域 ， 它 们 在 
第 一 次 被 请 求 执行 这 些 计算 的 时 候 ， 把 二 些 开销 中 的 计算 结果 缓存 
在 这 些 域 中 。 如 有 果 将 来 再 次 请 求 同 样 的 计算 ， 束 直接 返回 这 些 缓存 的 
值 ， 从 而 节约 了 重新 计算 所 需要 的 开销 。 这 种 技巧 可 以 很 好 地 工作 ， 

因为 对 象 是 不 可 变 的 ， 它 的 不 可 变性 保证 了 这 些 计算 如 果 被 再 次 执 

行 ， 束 会 产生 同样 的 结果 。 


例如 ， PhoneNumber 类 的 hashCode 方法 ( 见 第 9 条 ) 在 第 一 次 被 调用 的 
时 候 ， 计 算出 散 列 码 ， 然 后 把 它 缓存 起 来 ， 以 备 将 来 被 再 次 调用 时 使 
用 。 这 种 方法 是 下 砍 初始 化 (lazy initialization) ”( 见 第 71 条 ) 的 一 个 
PIF, string 类 也 用 到 了 。 


有 关 序 列 化 功能 的 一 条 告 诚 有 必要 在 这 里 提出 来 。 如 果 你 选择 让 目 己 
的 不 可 变 类 实现 serializable 接口 ， 并 且 它 包含 一 个 或 者 多 个 指 回 可 
变 对 象 的 域 ， 惑 必 须 提 供 一 个 显 式 的 readObject 或 者 readResolve J) 
法 ， 或 者 使 用 ObjectOutputStream.writeUnshared 和 

ObjectInputStream. readUnshared Wik: abi ree io e 
的 ， 也 是 如 此 。 和 否则 攻击 者 可 能 从 不 可 变 的 类 创建 可 变 的 实例 。 
话题 的 详细 内 容 请 参见 第 76 条 。 


站 之 ， 坚 决 不 要 为 每 个 get 方 法 编写 一 个 相应 的 set 方 法 。 BRIFA RA 
的 利用 要 让 类 成为 1 ENGL DL xe DS ATE > ANB EA RA 
ee 唯一 确定 寺 定 的 情况 下 存在 潜在 的 性 能 问题 。 你 应 该 

是 使 一 eA EEE. eer PhoneNumber 和 Complex ， 成 为 不 可 变 的 

ss 有 几 个 类 如 java.util.Date 和 java.awt.Point , 它 

们 本 应 该 是 不 可 变 的 ， 但 实际 上 却 不 是 ) 。 你 也 应 该 认真 考虑 把 一 些 


较 大 的 值 对 象 做 成 不 可 变 的 ， 例 如 string 和 siginteger 。 只 有 当 你 确 
认 有 必要 实现 令 人 满意 的 性 能 时 ( 见 第 55 条 ) ， 才 应 该 为 不 可 变 的 类 
提供 公有 的 可 变 配套 类 。 


对 于 有 些 类 而 言 ， 其 不 可 变性 是 不 切实 际 额 的 。 MRR RE MACE 
ASAT ZEW), DIRMI FREDO A EAD ATE TE o BIRT SR BY LEERY 
状态 数 ， 可 以 更 容易 地 分 析 该 对 象 的 行为 ， 同 时 降低 出 钳 的 可 能 性 。 
a A E T 
REE) 是 final ye’ 


构造 锅 应 该 创建 完全 初始 化 的 对 象 ， 并 建立 起 所 有 的 约束 关系 。 不 要 
再 构造 右 或 者 静态 工厂 之 外 再 提供 共有 的 初始 化 方法 ， 除 非 有 令 人 信 
服 的 理由 必须 这 么 做 。 同 样 地 ， 也 不 应 该 提供 “重新 初始 化 ”方法 E 
使 得 对 象 可 以 被 重用 ， 就 好 像 这 个 对 象 是 由 另 一 不 同 的 初始 状态 构造 
出 来 的 一 样 ) 。 与 所 增加 的 复杂 性 想必 , “重新 初始 化 "方法 通常 并 没 
有 市 来 太 多 的 性 能 优势 。 


可 以 通过 timertask 类 来 说 明 这 些 原 则 。 它 是 可 变 的 ， 但 是 它 的 状态 
空间 被 有 意 地 设计 得 非常 小 。 你 可 以 创建 一 个 实例 ， 对 它 进行 调度 使 
它 执行 起 来 ， 也 可 以 随意 地 取消 它 。 一 旦 一 个 定时 器 任务 (timer 
task) 已 经 完成 ， 或 者 已 经 取消 ， 就 不 可 能 再 对 它 重 新 调度 。 


最 后 值得 注意 的 一 点 与 本 条 目 中 的 compres 类 有 天。 这 个 例子 只 是 被 
用 来 演示 不 可 变性 的 ， 它 不 是 一 个 工业 强度 ( 即 产 品级 ) 的 复数 实 
现 。 它 对 复数 乘法 和 除法 使 用 标准 的 计算 公式 ， 会 进行 不 正确 的 舍 
入 ， 并 对 复数 nan 和 无 穷 大 没有 提供 很 好 的 语义 [Kaha91，Smith63， 
Thomas94] ° 


it: 
1. 即 改变 对 象 属性 的 方法 。 一 一 编辑 注 


第 16 条 : 复合 优 于 继承 


继承 (inheritance) 是 实现 代码 重用 的 有 力 手段 ， 但 它 并 非 永远 是 完成 
这 项 工作 的 最 佳 工具 。 使 用 不 当 会 导致 软件 变 得 很 脆弱 。 在 包 的 内 部 


使 用 继承 是 非常 安全 的 ， 在 那里 ， 子 类 和 超 类 的 实现 都 处 在 同一 个 程 
序 员 的 控制 之 下 。 对 于 专门 为 了 继承 而 设计 、 并 且 具 有 很 好 的 文档 的 
类 来 说 ( 见 第 17 条 ) ， 使 用 继承 也 是 非常 安全 的 。 然 而 ， 对 普通 的 具 
体 类 (concrete class) 进行 跨越 包 边 界 的 集成 ， 则 是 非常 危险 的 。 提 
示 一 下 ， 本 书 使 用 “继承 ”一 词 ， 含义 是 EMER (implementation 
inheritance ， 当 一 个 类 扩展 男 一 个 类 的 时 候 ) 。 本 条 目 中 讨论 的 问题 
并 不 适用 于 HOIEK (interface inheritance ， 当 一 个 类 实现 一 个 接口 
的 时 候 ， 或 者 当 一 个 接口 扩展 另 一 个 接口 的 时 候 ) 。 


TTA WANK x, ERAIK T EL TLTSnyder86] 。 换 句 话 说， 于 
类 依赖 于 其 超 类 中 特定 功能 的 实现 细节 。 超 类 的 实现 可 能 会 随 着 发 行 
版 本 的 不 同 而 有 所 变化 ， 如 采 真 的 发 生 了 变化 ， 子 类 可 能 会 遭 到 破 
坏 ， 即 使 它 的 代码 完全 没有 改变 。 因 而 ， 子 类 必须 要 跟着 其 超 类 的 更 
除非 超 类 是 专门 为 了 扩展 而 设计 的 ， 并 且 具 有 很 好 的 文档 
p ° 


为 了 说 明 得 更 加 具体 一 点 ， 我 们 假设 有 一 个 程序 使 用 了 nasnset 。 为 
了 调 优 改 程序 的 性 能 ， 需 要 查询 hasnset ， 看 一 看 自从 它 被 创建 以 来 
曾经 添加 了 多 少 个 元 素 (不 要 与 它 当 前 的 元 素 混 清 起 来 ， 元 素数 日 会 
随 着 元 素 的 删除 而 递减 ) 。 为 了 提供 这 种 功能 ， 我 们 得 编写 一 个 
Hashset 变量 ， 它 记录 下 视图 插入 的 元 素数 量 ， 并 针对 该 计数 值 导出 
—<] 访问 方法 ° HashSet 类 包含 两 个 可 以 增加 元 素 的 方法 : add 和 
addAll ， 因 此 这 两 个 方法 都 要 被 黎 兰 : 


// Broken - Inappropriate use of inheritance! 


public class InstrumentedHashSet < E > extends HashSet < E> { 


// The number of attempted element insertions 


private int addCount = 0; 


public InstrumentedHashSet () { 


} 


public InstrumentedHashSet ( int initCap, float loadFactor) 


super (initCap, loadFactor); 


@Override public boolean add (E e) { 


addCount++; 


return super .add(e); 


@Override public boolean addAll (Collection<? extends E> c) 


addCount += c.size(); 


return super .addAll(c); 


public int getAddCount () { 


return addCount; 


这 个 类 看 起 来 非常 合理 ， 但 是 它 不 能 正 党 工作。 假设 我 们 创建 了 一 个 
实例 ， 并 利用 agar 方法 添加 了 三 个 元 素 : 


InstrumentedHashSet<String> S = 
new InstrumentedHashSet<String>(); 


s.addAll(Arrays.asList( "Snap" , "Crackle" , "Pop" )); 


这 时 候 ， 我 们 期 望 getaddcounr 方法 将 会 返回 3， 但 是 它 实 际 上 返回 的 
是 6. 哪 里 出 错 了 呢 ? 在 hasnset 的 内 部 ， aoan 方法 是 基于 它 的 ad 
方法 来 实现 的 ， 即 使 nashset 的 文档 中 并 没有 说 明 这 样 的 实现 细 市 ， 
这 也 是 合理 的 ° InstrumentedHashSet 中 的 addAll 方法 首先 给 addCount 
增加 3， 然 后 利用 super.aaaa 来 调用 Hashset HY adaa 实现。 然后 又 
一 次 调用 到 被 InstrumentedHashSet 覆盖 了 的 add 方法 ， 每 个 元 素 调 用 
一 次 。 这 三 次 调用 又 分 别 给 adudcount 加 了 1， 所 以 ， 总 共 增 加 了 6: 通 
过 addAll 方法 增加 的 每 个 元 素 都 被 计算 了 两 次 。 


我 们 只 要 去 掉 补 覆盖 的 aoan 方法 ， 束 可 以 “修正 ”这 个 子 类 。 虽 然 这 
样 得 到 的 类 可 以 正常 工作 ,但 是 ， 它 的 功能 正确 性 则 需要 依赖 于 这 样 
的 事实 :Hashset 的 aaa 方法 是 在 它 的 ada 方法 上 实现 的 。 这 
种 “上 自用 性 (self-use) ”是 实现 细节 ， 不 是 承诺 ， 不 能 保证 在 Java 平 台 
的 所 有 实现 中 都 保持 不 变 ， 不 能 保证 随 着 发 行 版 本 的 不 同 而 不 发 生变 
化 a 因此 ， 这 样 得 到 的 InstrumentedHashSet 类 将 是 非常 脆弱 的 j 


稍微 好 一 点 的 做 法 是 ， 履 盖 aa 方法 来 遍历 指定 的 集合 ， 为 每 个 元 
素 调用 一 次 aga 方法 。 这 样 做 可 以 保证 得 到 正确 的 结果 ， 不 管 
HashSet 的 addAll 方法 是 否 在 add 方法 的 基础 上 实现 ， 因为 HashSet 
的 adda. 实现 将 不 会 再 被 调用 到 。 然 而 ， 这 项 技术 并 没有 解决 所 有 的 
问题 ， 它 相当 于 重新 实现 了 超 类 的 方法 ， 这 些 超 类 的 方法 可 能 是 目 用 
的 (self-use) ， 也 可 能 不 是 目 用 的 ， 这 种 方法 很 困难 ， 也 非常 耗 时 ， 
并 且 容 易 出 错 。 此 外 ， 这 样 做 并 不 总 是 可 行 的 ， 因 为 无 法 访问 对 于 子 
类 来 说 的 私有 域 ， 所 以 有 些 方法 就 无 法 实现 。 


导致 子 类 脆弱 的 一 个 相关 的 原因 是 ， 它 们 的 超 类 在 后 续 的 发 行 版 本 中 
可 以 获得 新 的 方法 。 假 设 一 个 程序 的 安全 性 依赖 于 这 样 的 事实 : 所 有 
被 插入 到 某 个 集合 中 的 元 素 都 满足 某 个 先决 条 件 。 下 面 的 做 法 就 可 以 
确保 这 一 点 : 对 集合 进行 子 类 化 ， 并 履 盖 所 有 人 能够 添加 元 素 的 方法 ， 
以 便 确 保 在 加 入 每 个 元 素 之 前 它 是 满足 这 个 先决 条 件 的 。 如 果 在 后 续 
的 发 行 版 本 中 ， 超 类 中 没有 增加 能 插入 元 素 的 新 方法 ， 这 种 做 法 就 可 
以 正常 工作 。 然 而 ， 一 旦 超 类 增加 了 这 样 的 新 方法 ， 则 很 有 可 能 仅仅 
由 于 调用 了 这 个 未 被子 类 履 盖 的 新 方法 ， 而 将 “非法 的 ”元素 添 加 a 到 子 
类 的 实例 中 。 这 不 是 个 纯粹 的 理论 问题 。 在 把 hashtable 和 vector 加 
i Collections Framework 中 的 时 候 ， 束 修正 了 几 个 这 类 性 质 的 安全 漏 
{lA} ° 


上 面 这 两 个 问题 都 来 源 于 覆盖 (overriding) 动作 。 如 果 在 扩展 一 个 类 
的 时 候 ， 仅 仅 是 增加 者 的 方法 ， 而 不 履 凋 现 有 的 方法 ， 你 可 能 会 认为 
这 是 安全 的 。 虽 然 这 种 扩展 方式 比较 安全 一 些 ， 但 是 也 并 非 完 全 没有 
风险 。 如 采 超 类 在 后 续 的 发 行 版 本 中 获得 了 一 个 新 的 方法 ， 并 且 不 笠 
的 是 ， 你 给 子 类 提供 了 一 个 签名 相同 但 返回 类 型 不 同 的 方法 ， 那 么 这 
样 的 子 类 将 无 法 通过 编译 [JLS，8.4.6.3]。 如果 给 子 类 提供 的 方法 带 有 
与 新 的 超 类 方法 完全 相同 的 签名 和 返回 类 型 ， 实 际 上 就 覆盖 了 超 类 中 
的 方法 ， 因 此 又 回 到 上 述 的 两 个 问题 上 去 了 。 此 外 ， 你 的 方法 是 否 能 
够 革 守 新 的 超 类 方法 的 约定 ， 这 也 是 很 值得 怀疑 的 ， 因 为 当 你 在 编写 
子 类 方法 的 时 候 ， 这 个 约定 根本 没有 面世 。 


注 运 的 是 ， 有 一 种 办 法 可 以 避免 前 面 提 到 的 所 有 问题 。 不 用 扩展 现 有 
的 类 ， 而 是 在 新 的 类 中 增加 一 个 私有 域 ， 它 引用 现 有 类 的 一 个 实例 。 
这 种 设计 被 称 作 “ 2G (composition) ”， 因 为 现 有 的 类 变 成 了 新 类 的 
一 个 组 件 。 新 类 中 的 每 个 实例 方法 都 可 以 调用 被 包含 的 现 有 类 实例 中 
对 应 的 方法 ， 并 返回 它 的 结果 。 这 被 称 为 HX (forwarding) , #2 
中 的 方法 被 称 为 2X2 777F (forwarding method) 。 这 样 得 到 的 类 将 会 
韭 常 稳 固 ， 它 不 依赖 于 现 有 类 的 实现 细节 。 即 使 现 有 类 添加 了 新 的 方 
法 ， 也 不 会 影响 新 的 类 。 为 了 进行 更 具体 的 说 明 ， 请 看 下 面 的 例子 ， 
它 用 复合 /转发 的 方法 来 代替 InstrumentedHashSet 类 ° 注意 这 个 实现 分 为 
两 部 分 : 类 本 身 和 可 重用 的 F228 (forwarding class) ， 包 含 了 所 有 
的 转发 方法 ， 没 有 其 他 方法 。 


// Wrapper class uses compsition in place of inheritance 


public class InstrumentedSet < E > extends ForwardingSet < E > { 


private int addCount = 0; 


public InstrumentedSet (Set<E> s) { 


super (Ss); 


@Override public boolean add (E e) { 


addCount++; 


return super .add(e); 


@Override public boolean addAll (Collection<? extends E> c) 


addCount += c.size(); 


return super .addAll(c); 


public int getAddCount () { 


return addCount; 


// Reusable forwarding class 


public class ForwardingSet < E > implements Set < E> { 


private final Set<E> s; 


public ForwardingSet (Set<E> s) dithis PSE- se 


public void clear () { s.clear(); } 


public boolean contains (Object o) { return s.contains(o); } 


public boolean isEmpty () { return s.isEmpty(); } 
public int size () { return s.size(); } 
public Iterator<E> iterator () { return s.iterator(); } 

public boolean add (E e) { return s.add(e); } 
public boolean remove (Object o) { return s.remove(o); } 


public boolean containsAll (Collection<?> c) 


{ return s.containsAll(c); } 


public boolean addAll (Collection<? extends E> c) 


{ return s.addAll(c); } 


public boolean removeAll (Collection<?> c) 


{ return s.removeAll(c); } 


public boolean retrainAll (Collection<?> c) 


{ return s.retainAll(c); } 


public Object[] toArray() { return s.toArray(); } 


public <T> T[] toArray(T[] a) { return s.toArray(a); } 


@Override public boolean equals (Object o) 
{ return s.equals(o); } 


@Override public int hashCode () { return s.hashCode(); } 


@Override public String toString () { return s.toString(); } 


Set 接口 的 存在 使 得 InstrumentedSet 类 的 设计 成 为 可 能 ， 因为 Set 接 
口 保存 了 Hasnset 类 的 功能 特性 。 除 了 获得 健壮 性 之 外 ， 这 种 设计 也 
带 来 了 格外 的 灵活 性 。 instrumentedset 类 实现 了 se 接口， 并且 拥 有 
单个 构造 右 ， 它 的 参数 也 是 set 类 型 。 从 本 质 上 讲 ， 这 个 类 把 一 个 

set 转变 成 了 男 一 个 set ， 同 时 增加 了 计数 的 功能 。 前 面 提 到 的 基 
于 继承 的 方法 只 适用 于 单个 具体 的 类 ， 并 且 对 于 超 类 中 所 支持 的 每 个 
构造 硕 都 要 求 有 一 个 单独 的 构造 器 ， 与 此 不 同 的 是 ， 这 里 的 包装 类 

(wrapper class) # 可 以 被 用 来 包装 任何 set 实现 ， 并 且 可 以 结合 任何 


先前 存在 的 构造 右 一 起 工作 。 例 如 : 


InstrumentedSet<Date>( new TreeSet<Date>(cmp)); 


Set<Date> s = new 


Set<E> s2 = new InstrumentedSet<E>( new HashSet<E>(capacity) ); 


— 类 甚至 也 可 以 用 来 临时 替换 一 个 原本 没有 技术 特性 的 
set 实例 : 


static void walk (Set<Dog> dogs) { 
InstrumentedSet<Dog> iDogs = new InstrumentedSet<Dog>(dogs); 


// Within this method use iDogs instead of dogs 


因为 每 一 个 InstrumentedSet 实例 都 把 另 一 个 Set 实例 包 帮 起 来 了 ， 所 
以 InstrumentedSet 类 被 称 作 ARE (wrapper class) 。 这 也 正 是 
Decorator 模 式 [Gamma95， p.175]， 因 为 instrumentedset 类 对 一 个 集合 
进行 了 修饰 ， 为 它 增 加 了 技术 特性 。 有 时候， 复合 和 转发 的 结果 也 被 
错误 地 成 为 “ 委 大 (delegation) ”。 从 技术 的 角度 而 言 ， 这 不 是 委 
托 ， 除 非 包 装 对 回 把 目 身 传递 给 被 包装 的 对 象 [Gamma95，p.20] ° 


包装 类 几乎 没有 什么 缺点 。 需 要 注意 的 一 点 是 ， 包 装 类 不 适合 用 在 A 
JJJEZE (callback framework) F; 在 回调 框架 中 ， 对 象 把 自身 的 引用 
传递 给 其 他 的 对 象 ， 用 于 后 续 的 调用 (“la”) 。 因 为 被 包装 起 来 的 
对 象 并 不 知道 它 外 面 的 包装 对 象 ， 所 以 它 传 递 一 个 指向 自身 的 引用 ( 
this ) ， 回 调 时 避 开 了 外 面 的 包装 对 象 。 这 被 称 为 SELF 问题 
[Lieberman86]。 有 些 人 但 系 转发 方法 调用 所 再 来 的 性 能 影响 ， 或 者 包 
装 对 辐 导 致 的 内 存 占用 。 在 实践 中 ， 这 两 者 都 不 会 造成 很 大 的 影响 。 
编写 转发 方法 倒是 有 点 琐碎 ， 但 是 只 需要 给 每 个 接口 编写 一 次 构造 
厂 ， 转 发 类 则 可 以 通过 包含 接口 的 包 替 你 提供 。 


只 有 当 子 类 真正 是 超 类 的 子 关 型 (subtype) 时 ， 才 适合 用 继承 。 换 
句 话说 ， 对 于 两 个 类 A 和 B， 只 有 当 两 者 之 间 确 实 存 在 “is-a" 关 系 的 时 
IR, RBT MIZY RERA ° WRH RRB RRA, WMA hh A 
C: 每 个 B 确 实 也 是 A 吗 ? 如 果 你 不 能 够 确定 这 个 问题 的 答案 是 肯定 
的 ， 那 么 B 束 不 应 该 扩展 A。 如 果 管 案 是 否定 的 ， 通 常情 况 下 ，B 应 该 


BAN MLAB, HERRAR ` RAAPI: A 本 质 
上 不 是 B 的 一 部 分 ， 只 是 它 的 实现 细节 而 已 。 


在 Java 平 台 类 库 中 ， 有 许多 明显 违反 这 条 原则 的 地 方 。 例 如 ， 栈 
(stack) 并 不 是 向 量 (vector) ， 所 以 stack 不 应 该 扩展 vector ° [Al 
样 地 ， 属 性 列表 也 不 是 散 列 表 ， 所 以 properties 不 应 该 扩展 hashtable 
° 在 这 两 种 情况 下 ， 复 合 模式 才 是 恰当 的 。 


如 果 在 适合 于 使 用 复合 的 地 方 使 用 了 继承 ， 则 会 不 必要 地 骏 露 实现 细 
节 。 这 样 得 到 的 API 会 把 你 限制 在 原始 的 实现 上 ， 永 远 限定 了 类 的 性 
能 。 更 为 严重 的 是 ， 由 于 炊 露 了 内 部 的 细节 ， 客 户 端 就 有 可 能 直接 访 
问 这 些 内 部 细 广 。 这 样 至 少 会 导致 语义 上 的 混淆 。 例 如 ， 如 果 。 指 
[=] properties XM, HPA p.getproperty(key) 就 有 可 能 产生 与 p.get(key) 
不 同 的 结果 : 前 者 考虑 了 默认 的 属性 表 ， 而 后 者 是 继承 目 Hashtable 
的 ， 它 则 没有 考虑 默认 属性 列表 。 最 严重 的 是 ， 客 户 有 可 能 直接 修改 
超 类 ， 从 而 破坏 子 类 的 约束 条 件 。 在 properties 的 情形 中 ， 设 计 者 的 
目标 是 ， 只 允许 字符 串 作 为 键 (key) 和 值 (value) ， 但 是 直接 访问 
RBH) hashtable 束 可 以 违反 这 种 约束 条 件 。 一 旦 违反 了 约束 条 件 ， 
就 不 可 能 再 使 用 Properties API 的 其 他 部 分 ( load 和 store ) F o 等 
到 发 现 这 个 问题 时 ， 要 改正 它 已 经 为 时 太 晚 了 了， 因为 客户 端 依赖 于 使 
FASE AFAR BEATE T ° 


在 决定 使 用 继承 而 不 是 复合 之 前 ， 还 应 该 问 目 己 最 后 一 组 问题 。 对 于 
你 正 试图 扩展 的 类 ， 它 的 API 中 有 没有 页 陷 呢 ?如 琳 有 ， 你 是 否 愿 意 
把 那些 缺陷 传播 到 类 的 API 中 ? 继承 机 制 会 把 超 类 API 中 的 所 有 缺陷 传 
播 到 子 类 中 ， 而 复合 则 允许 设计 新 的 API 来 隐藏 这 些 缺 陷 。 


人 简 而 言 之 ， 继 和 承 的 功能 非常 强大 ， 但 是 也 存在 诸多 问题 ， 因 为 它 违背 
了 封装 原则 。 只 有 当 子 类 和 超 类 之 间 确 实 存在 子 类 型 关系 古 ， 使 用 继 
承 才 是 恰当 的 。 即 便 如 此 ， 如 果子 类 和 超 类 处 在 不 同 的 包 中 ， 并 且 超 
类 并 不 是 为 了 继承 而 设计 的 ， 那 么 就 成 将 会 导致 脆弱 性 (fragility) 。 
为 了 避免 这 种 脆弱 性 ， 可 以 用 复合 和 转发 机 制 来 代替 继承 ， 尤 其 是 当 
存在 适当 的 接口 可 以 实现 包装 类 的 时 候 。 包 装 类 不 仅 比 子 类 更 加 健 
壮 ， 而 且 功 能 也 更 加 强大 。 


第 17 条 : 要 么 为 继承 而 设计 ， 并 提供 
SCRA, EA WEAR IE ARK 


第 16 条 提醒 我 们 ， 对 于 不 是 为 了 继承 而 设计 、 并 且 没 有 文档 说 明 的 “外 
来 ”类 进行 子 类 化 是 多 么 危险 。 那 么 对 于 专门 为 了 继承 而 设计 并 且 具 有 
民 好 文档 说 明 的 类 而 言 ， 这 又 意味 着 什么 呢 ? 


首先 ， 该 类 的 文档 必须 精确 地 描述 多 兰 每 个 方法 所 市 来 的 影响 。 换 句 
话说 ， ARUNA XPM CARA (overridable) WAIN AA 

(self-use) 。 对 于 每 个 公有 的 或 受 保护 的 方法 或 者 构造 器 ， 它 的 文档 
必须 指明 该 方法 或 者 构造 右 调 用 了 哪些 可 和 窗 蓄 的 方法 ， 古 以 什么 顺序 
调用 的 ， 每 个 调用 的 结果 又 是 如 何 影 响 后 续 的 处 理 过 程 的 〈 所 谓 可 履 
m (overridable) 的 方法 ， 是 指 非 rina 的 ， 公 有 的 或 受 保护 的 ) 。 
Ah, KUME PA, EET PE aa E AA 
法 。 例 如 ， 后 台 的 线程 或 者 静态 的 初始 化 器 (initializer) 可 能 会 调用 
这 样 的 方法 。 


按 惯例 ， 如 果 方 法 调用 到 了 可 履 盖 的 方法 ， 在 它 的 文档 注释 末尾 应 该 
包含 关于 这 些 调用 的 摘 述 信息 。 这 段 描 述 信 息 要 以 这 样 的 句子 开 

$: “This implementation. (该 实现 ..…....) ”。 这 样 的 句子 不 应 该 被 认为 
是 在 表明 该 行为 可 能 会 随 着 版 本 的 变迁 而 改变 。 它 意味 着 这 段 描 述 天 
注 该 方法 的 内 部 工作 情况 。 下 面 是 个 示例 ， 摘 目 


java.util.AbstractCollection 的 规范 : 


public boolean remove(Object o) 


Removes a single instance of the specified element from this colletion, 
if it is present(optional operation). More formally, removes an element 
e such that (o==null ? e==nul : o.equals()) , if the collection contains 
one or more such elements. Returns true if the collection contained 
the specified element (or equivalently, if the collection changed as a 
result of the call). 


This implementation iterates over the collecting looking for the 
specified element. If it finds the elements, it removes the element from 
the collection using the iterators's remove method. Note that this 


implementation throws an unsupportedoperationexception if the iterator 
returned by this collection's iterator method does not implement the 
remove method. 


(MAIS TRG eR Sh 就 从 中 删除 该 指定 元 素 中 的 
单个 实例 (这 是 项 可 选 的 操作 。 更 一 般 地 ， 如 采集 合 中 包含 一 
个 或 者 多 个 这 样 的 元 素 e， 就 从 中 删除 这 种 元 素 ， 以 便 (onun ? 
e==nul : o.equals()) -o URRE HEEE AIC A I E true 

《如 果 调 用 最 终 改变 了 集合 ， 也 一 样 ) 。 


该 实现 轴 历 整个 集合 来 查找 指定 的 元 素 。 如 果 它 找到 该 元 素 ， 将 
SA FIA AEAY remove 方法 将 之 从 集合 中 删除 。 。 注意 ， 如 果 由 该 
集合 的 iterator FREI IA as 没有 实现 remove 方法 ， 该 实 

现 束 会 抛 出 UnsupportedOperationException ° ) 


该 文档 清楚 地 说 明了 ， 和 窗 盖 iterator 方法 将 会 影响 remove 方法 的 行 
为 。 而 且 ， 它 确切 地 摘 述 了 iterator 方法 返回 的 Iterator 的 行为 将 会 怎 
样 影响 remove 方法 的 行为 。 与 此 相反 的 是 ， 在 第 16 条 的 情形 中 ， 程 序 
员 在 a. perom AYE, HEWA a 方法 是 否 会 影响 
addAll 7 


天 于 程序 文档 有 人 句 格 言 : 好 的 API 文 档 应 该 描述 一 个 给 定 的 方法 做 了 
件 么 工作 ， 而 个 征 描述 它 是 奶 厅 做 到 的 。 那 么 ， 上 面 这 种 做 法 是否 违 
育 了 这 句 格言 呢 ? 十 的 ， 它 确实 违背 了 ! 这 正 是 继承 破坏 了 封装 性 所 
带 来 的 不 行 后 采 。 所 以 ， 为 了 设计 一 个 类 的 文档 ， 以 便 它 能 够 安全 地 

子 类 化 ， 你 必须 摘 述 清楚 那些 有 可 能 未 定义 的 实现 细 证 。 


为 了 继承 而 进行 的 设计 不 仅仅 设计 目 用 模式 的 文档 设计 。 为 了 使 程序 
员 能 够 编写 出 更 加 有 效 的 子 类 ， 而 无 需 承 党 不 必要 的 痛 否 ， KOIA 
FE che Hh SAFI (hook) ， 以 您 能 够 水 入 到 它 的 内 就 工作 
PFEP, IPREN ZRI KI (protected) DE, tH 
ee a Oe š 例如 ， 2 java.util.AbstractList 

`J removeRange y 


protected void removeRange(int fromIndex, int toIndex) 


Removes from this list all of the elements whose index is between 
fromindex , inclusive, and torndex , exclusive. Shifts any elements to 


the left (reduces their index). This call shortens the arraytist by ( 
toIndex - ‘fromIndex') elements. (If totndex==fromindex , this operation 
has no effect.) 


This method is called by the clear operation on this list and its sublists. 
Overriding this method to take advantage of the internals of the list 
implementation can substantially imporve the performance of the 

clear Operation on this list and its sublists. 


This implementation get a list iterator positioned before fromtndex and 
repeatedly calls Listiterator.next follows by ListIterator.remove , until 
the entire range has been removed. Note: If Listrterator.remove 

requires linear time, this implementation requires quadratic time. 


Parameters: 
fromIndex index of first element to be removed. 


toIndex index after last element to be removed. 


(从 列表 中 删除 所 有 索引 处 于 fromIndex (= ) 和 toIndex (不 
a) 之 间 的 元 素 。 将 所 有 符合 条 件 的 元 素 移 到 左边 ( 减 小 索 

弓 | ) 。 这 一 调用 将 从 ArrayList 中 删除 ( toIndex - fromIndex ) A 
间 的 元 素 (如 果 toIndex == fromIndex , 这 项 操作 就 无 效 9 ) 


个 方法 是 通过 crear 操作 在 这 个 列表 及 其 自 列表 中 调用 的 。 和 枚 
盖 这 个 方法 来 利用 列表 实现 的 内 部 信息 ， 可 以 充分 地 改善 这 个 列 
表 及 其 子 列表 中 的 crear 操作 的 性 能 。 


这 项 实现 获得 了 一 个 处 在 fromIndex 之 前 的 列表 和 迭 as 并 一 次 
地 重复 调用 TERES remove 和 ListIterator.next 直到 整个 范 
围 都 被 移 除 为 止 。 ce: 如 采 ListIterator.remove 需要 线性 的 时 
lA], SEE 平方 汲 的 时 间 


BM: 
fromIndex 要 移 除 的 第 一 | 元 素 的 索引 
toIndex 要 移 除 的 最 后 一 个 元 素 之 后 的 索引 ) 


这 个 方法 对 于 List 实现 的 最 终 用 户 并 没有 意义 。 提 供 该 方法 的 唯一 

目的 在 于 ， 使 子 类 更 易于 提供 针对 子 列 表 (sublist) 的 快速 clear 77 

法 。 如 果 没 有 removeRange 方法 ， 当 在 子 列表 (sublist) 上 调用 clear 

方法 时 ， 子 类 将 不 得 不 用 平方 级 的 时 间 (quadratic performance) 来 完 

a o 否则 ， 就 得 重新 编写 整个 subList 机 制 一 一 这 可 不 是 件 容 
事情 1 


因此 ， 当 你 为 了 继承 而 设计 类 的 时 候 ， 如 何 决定 应 该 又 露 哪些 受 保护 
的 方法 或 者 域 呢 ? 遗憾 的 是 ， 并 没有 神奇 的 法 则 可 供 你 使 用 。 你 所 能 
做 到 的 最 佳 途径 束 是 努力 思考 ， 发 挥 最 好 的 想象 ， 然 后 编写 一 些 子 类 
进行 测试 。 你 应 该 尽 可 能 少 地 又 露 受 保护 的 成 员 ， 因 为 每 个 方法 或 者 
域 都 代表 了 一 项 关于 实现 细节 的 承 诡 。 另 一 方面 ， 你 又 不 能 暴露 得 太 
少 ， 因 为 漏 掉 的 受 剑 护 方法 可 能 会 导致 这 个 类 无 法 个 真正 用 于 继承 。 


XITA SARA MIRTH, E-MAIL ERS FA o WMR 
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加 明显 。 相 反 ， 如 采编 写 了 多 个 子 类 ， 并 且 无 一 使 用 受 保护 的 成 员 ， 

或 许 吏 应 该 把 它 做 成 和 有 的 。 经 验 表 明 ，3 个 子 类 通 音 吏 足以 测试 一 个 
和 


在 为 了 继承 而 设计 有 可 能 被 广泛 使 用 的 类 时 ， 必 须要 意识 到 ， 对 于 文 
档 中 所 说 明 的 自用 模式 ( self-use pattern) ， 以 及 对 于 其 受 保护 方法 
和 域 中 所 隐 售 的 实现 策略 ， 你 实际 上 已 经 做 出 了 KA 的 承诺 。 这 些 承 
诺 使 得 你 在 后 续 的 版 本 中 提高 这 个 类 的 性 能 或 者 增加 狐 功 能 都 变 得 非 
a ne nomen ye ned 
Miz ° 


还 要 注意 ， 因 继承 而 需要 的 特殊 文档 会 打 乱 正常 的 文档 信息 ， 普 通 的 
文档 被 设计 用 来 让 程序 员 可 以 创建 该 类 的 实例 ， 并 调用 类 中 的 方法 。 
在 编写 本 书 之 时 ， 几 乎 还 没有 适当 的 工具 或 者 注释 规范 ， 能 够 把 “普通 
的 API 文 档 " 与 “专门 针对 实现 子 类 的 程序 员 的 信息 ?分开 来 。 


为 了 允许 继承 ， 类 还 必须 遵守 其 他 一 些 约束 。 Pee aR BE V/A AT BE 
敌 间 的 万 沪 ， 无 论 是 直接 调用 还 是 间接 调用 。 如 采 违 反 了 这 条 规则 ， 
很 有 可 能 导致 程 序 失 败 。 超 类 的 构造 右 在 子 类 的 构造 器 之 前 运行 ， 所 
以 ， 子 类 中 用 志 版 本 的 方法 将 会 在 子 类 的 构造 器 运行 之 前 整 先 被 调 

用 。 如 采 该 覆盖 版 本 的 方法 依赖 于 子 类 构造 占 所 执行 的 任何 初始 化 工 


作 ， 该 方法 将 不 会 如 预期 般 地 执行 。 为 了 更 加 直观 地 说 明 这 一 点 ， 下 
面 举 个 例子 ， 其 中 有 个 类 违反 了 这 条 规则 : 


public class Super { 
// Broken - constructor invokes an overridable method 
public Super () { 


overrideMe(); 


public void overrideMe () { 


FHT REN] I overrideMe , Super 唯一 的 构造 器 就 错误 地 调 
FAS IX TATE: 


public final class Sub extends Super { 


private final Date date; // Blank final, set by constructor 


Sub() { 


date = new Date(); 


// Overriding method invoked by superClass constructor 
@Override public void overrideMe () { 


System.out.println(date) ; 


public static void main (String[] args) { 
Sub sub = new Sub(); 


sub.overrideMe(); 


你 可 能 会 期 香 这 个 程序 打印 出 日 期 两 次 ， 但 是 它 第 一 次 打印 出 的 是 
null , KA overrideMe 方法 被 Super 构造 器 调用 的 时 候 ， Ree as 
sub 还 没有 机 会 初始 化 date 域 。 注 意 ， 这 个 程序 观察 到 的 fina E 
处 于 两 种 不 同 的 状态 。 还 要 注意 ， 如 果 overrideMe 已 经 调用 了 date 
中 的 任何 方法 ， 4 Super 构造 器 调用 overrideMe 的 时 候 ， 调用 就 会 抛 
出 NullPointerException 异常 。 如 果 改 程序 没有 抛 出 NullPointerException 
a ME— AY JER A EP printin 方法 对 于 处 理 null 参数 有 着 特殊 
规定。 


在 为 了 继承 而 设计 类 的 时 候 ， Cloneable 和 Serializable 接 O 出 现 了 特 
殊 的 困难 。 如 果 类 是 为 了 继承 而 被 设计 的 ， 无 论 实现 这 其 中 的 哪个 接 
口 通 各 都 不 是个 好 主意 ， 因 为 它们 把 一 些 症 执行 的 负担 转 巡 到 了 扩展 
这 个 类 的 程序 员 的 映 上 。 然 而 ， 你 还 是 可 以 采取 一 些 特殊 的 手段 ， 使 
得 子 类 实现 这 些 接口 ， 无 需 强迫 了 于 类 的 程序 员 去 承受 这 些 负 担 。 第 11 
条 和 第 74 条 中 讲述 了 这 些 特殊 的 手段 。 


如 果 你 决定 在 一 个 为 了 继承 而 设计 的 类 中 实现 cloneable 和 
Serializable 接口 ， 就 应 该 意识 到 ， 因为 clone 和 readObject 方法 在 行 
为 上 非常 类 似 于 构造 医 ， 所 以 类 似 的 限制 规则 也 十 适用 的 : EEE 
clone JRE readopject , ARATE mnie, PEELA 
Pe TT Ll eo XIF readobject 而 言 ， 窗 盖 版 本 的 方法 将 在 子 类 的 
clone 方法 有 机 会 修正 被 区 隆 对 象 的 状态 之 前 被 运行 。 无 论 哪 种 情 
形 ， 都 不 可 避免 地 将 导致 程序 失败 。 在 cioe 方法 的 情形 中 ， 这 种 失 
败 可 能 会 同时 损害 到 原始 的 对 象 以 及 被 克隆 的 对 象 本 身 。 例 如 ， 如 采 
敌 蓄 版 本 的 方法 假设 它 正在 修改 对 象 深层 结构 的 克隆 对 象 的 备份 ， 玖 
会 发 生 这 种 情况 ， 但 是 该 备份 还 没有 完成 。 


最 后 ， 如 有 果 你 决定 在 一 个 为 了 继承 而 设计 的 类 中 实现 serializable ， 
并 且 该 类 有 一 个 readResolve 或 者 writeReplace 方法 ， 就 必须 使 用 
readResolve 或 者 writeReplace 成 为 受 保 护 的 方法 ， 而 不 是 私有 的 方 
法 。 如 果 这 些 方法 是 私有 的 ， 那 么 子 类 将 会 不 声 不 啊 地 忽略 掉 这 两 个 
方法 。 这 正 是 “为 了 允许 继承 ， 而 把 实现 细 世 变 成 一 个 类 的 API 的 一 部 
分 ”的 另 一 种 情形 。 


到 现在 为 止 ， 应 该 很 明显 为 了 纵 磺 历 充 订 类 ， 对 这 个 类 会 有 一些 赴 
笑 质 位 有 的 记 币 。 这 并 不 是 很 轻松 就 可 以 承诺 的 决定 。 在 某 些 情况 下 ， 
这 样 的 决定 很 明显 是 正确 的 ， 比 如 抽象 类 ， 包 括 接 口 的 ASCH 

(skeletal implementation) (W185) 。 但 是 ， 在 男 一 些 情况 下 ， 
这 样 的 决定 却 很 明显 是 错误 的 ， 比 如 不 可 变 的 类 ( 见 第 15 条 ) 。 


但 是 ， 对 于 普通 的 具体 类 应 该 怎么 办 呢 ? 它们 既 不 是 fina 的 ， 也 不 

是 为 了 子 类 化 而 设计 和 编写 文档 的 ， 所 以 这 种 状况 很 危险 。 每 次 对 这 

种 类 进行 修改 ， 从 这 个 类 扩展 得 到 的 客户 类 惑 有 可 能 遭 到 破坏 。 这 不 

仅仅 是 个 理论 问题 。 对 于 一 个 并 非 为 了 继承 而 设计 的 非 tinat 具体 

了 它 的 内 部 实现 之 后 ， 接 收 到 与 子 类 化 相关 的 错误 报告 也 
SLA as 


IX PALS BERR TD BRE, NTF ABAGEA T ZEHAT FRE 
充 计 彻 编写 文 焙 HJ 关 ， 要 玲子 关 化 。 有 两 种 办 法 可 以 禁止 子 类 化 。 
比较 容易 的 办 法 是 把 这 个 类 声明 为 tina 的 。 男 一 种 办 法 是 把 所 有 的 
构造 硕 都 要 成 和 有 的 ， 或 者 包 级 私有 的 ， 并 增加 一 些 公有 的 静态 工厂 
方法 类 替代 构造 禹 。 后 一 种 办 法 在 第 15 条 中 讨论 过 ， 它 为 内 部 使 用 子 
类 提供 了 灵活 性 。 这 两 种 办 法 都 是 可 以 接受 的 。 


这 条 建议 可 能 回 引 来 争议 ， 因 为 许多 程序 员 已 经 习惯 于 对 普通 的 具体 
类 进行 子 类 化 ， 以 便 增 加 新 的 功能 设施 ， 比 如 仪表 功能 

instrumentation， 如 计数 显示 等 ) 、 通 知 机 制 或 者 同步 功能 ， 或 者 为 
了 限制 原 有 类 中 的 功能 。 如 果 类 实现 了 某 个 能 够 反映 其 本 质 的 接口 ， 
比如 set 、 List 或 者 map ， 就 不 应 该 为 了 禁止 子 类 化 而 感到 后 
悔 。 第 16 条 中 介绍 的 ZEA (wrapper class) 模式 提供 了 另 一 种 更 好 
的 办 法 ， 让 继承 机 制 实 现 更 多 的 功能 。 


如 果 具 体 的 类 没有 实现 标准 的 接口 ， 那 么 禁止 继承 可 能 会 给 有 些 程序 
员 市 来 不 便 。 如 果 你 认为 必须 允许 从 这 样 的 类 继承 ， 一 种 合理 的 办 法 
征 确 保 这 个 类 永远 不 会 调用 它 的 任何 可 黎 关 的 方法 ， 并 在 文档 中 说 明 
这 一 点 。 换 句 话 说， 完全 消除 这 个 类 中 可 禾 兰 方法 的 目 用 特性 。 这 样 
做 之 后 ， 束 可 以 创建 “能 够 安全 地 进行 子 类 化 ”的 类 。 禾 许 方 法 将 永远 
也 不 会 影响 到 其 他 任何 方法 的 行为 。 


你 可 以 机 械 地 消除 类 中 可 禾 盖 方法 的 自用 特性 ， 而 不 改变 它 的 行为 。 
将 每 个 可 覆盖 的 代码 体 移 到 一 个 私有 的 “辅助 方法 (helper 

method) ”中 ， 并 且 让 每 个 可 覆盖 的 方法 调用 它 的 私有 辅助 方法 。 然 
人 可 履 盖 方法 的 私有 辅助 方法 ”来 代替 “可 履 盖 方法 的 每 
| 调用 ”。 


Bisse: 接口 优 于 抽象 类 


Java 程 序 设计 语言 提供 了 两 种 机 制 ， 可 以 用 来 定义 允许 多 个 实现 的 类 
型 : 接口 和 抽象 类 。 这 两 种 机 制 之 间 最 明显 的 区 别 在 于 ， 抽 象 类 允许 
包 侣 某 些 方法 的 实现 ， 但 是 接口 则 不 允许 。 一 个 更 为 重要 的 区 别 在 
于 ， 为 了 实现 由 抽象 类 定义 的 类 型 ， 类 必须 成 为 抽象 类 的 一 个 子 类 。 
任何 一 个 类 ， 只 要 它 定 义 了 所 有 必要 的 方法 ， 并 且 遵 守 通 用 约定 ， 它 
就 补 允 许 实现 一 个 接口 ， 而 不 管 这 个 类 是 处 于 类 层次 (class 
hierarchy) 的 哪个 位 置 。 因 为 Java 只 允许 单 继承 ， 所 以 ， 抽 象 类 作为 
类 型 定义 受到 了 极 大 的 限制 。 


现 有 的 类 可 以 很 容易 被 更 新 ， 以 实现 新 的 接口 。 如 果 这 些 方法 尚 不 存 
在 ， 你 所 需要 做 的 就 只 是 增加 必要 的 方法 ， 然 后 在 类 的 声明 中 增加 一 
个 implements $A] o 例如 ， 当 Comparable 接口 被 引入 到 Java 平 台中 
EF, 会 更 新 许多 现 有 的 类 ， 以 实现 Comparable 接口 。 一 般 来 说 ， 无 法 
更 新 现 有 的 类 来 扩展 新 的 抽象 类 。 如 有 果 你 和 希望 让 两 个 类 扩展 同一 个 抽 
象 类 ， 就 必须 把 抽象 类 放 到 类 型 层次 (type hierarchy) 的 高 处 ， 以 便 
这 两 个 类 的 一 个 祖先 成 为 它 的 子 类 。 遗 憾 的 是 ， 这 样 做 会 间接 地 伤害 
到 类 层次 ， 迫 使 这 个 公共 祖先 的 所 有 后 代 类 都 扩展 这 个 新 的 抽象 类 ， 
无 论 它 对 于 这 些 后 代 类 是 否 合适 。 


接口 是 定义 mixin (混合 类 型 ) 的 理想 选择 。 不 严格 地 将 ，mixin 是 指 
这 样 的 类 型 : 类 除了 实现 它 的 “基本 类 型 (primitive type) ”之 外 ， 还 可 
以 实现 这 个 mixin 接 口 ， 以 表明 她 提供 了 某 些 可 供 选 择 的 行为 。 例 如 ， 
Comparable 是 一 个 mixin 接 口 ， 它 允许 类 表明 它 的 实例 可 以 与 其 他 的 可 
相互 比较 的 对 象 进 行 排序 。 这 样 的 接口 之 所 以 被 称 为 mixin， 是 因为 它 
允许 任 选 的 功能 可 被 混合 到 类 型 的 主要 功能 中 。 抽 和 象 类 不 能 被 用 于 定 
义 mixin， 同 样 也 是 因为 它们 不 能 被 更 狐 到 现 有 的 类 中 : 类 不 可 能 有 一 
个 以 上 的 父 类 ， 类 层次 结构 中 也 没有 适当 的 地 方 来 插入 mixin 。 


接口 允许 我 们 构造 非 层 次 结构 的 类 型 框架 。 类 型 层次 对 于 组 织 某 些 事 
物 是 非常 合适 的 ， 但 是 其 他 有 些 事物 并 不 能 被 整齐 地 组 织 成 一 个 严格 
的 层次 结构 。 例 如 ， 假 设 我 们 有 一 个 接口 代表 一 个 singer (歌唱 家 ) ， 
男 一 个 接口 代表 一 个 songwriter (作曲 家 ) : 


public interface Singer { 


AudioClip sing (Song s) ; 


public interface Songwriter { 


Song compose ( boolean init) ; 


在 现实 生活 中 ， 有 些 歌唱 家 本 号 也 是 作曲 家 。 因 为 我 们 使 用 了 接口 而 
不 是 抽象 类 来 定义 这 些 类 型 ， 所 以 对 于 单个 类 而 言 ， 它 同时 实现 
Singer 和 Songwriter 是 完全 人 允许 的 ° 实际 上 ， 我 们 可 以 定义 第 三 个 接 
口 ， 它 同时 扩展 了 singer 和 songwriter ， 并 添加 了 一 些 适合 于 这 种 组 
合 的 新 方法 : 


public interface SingerSongwriter extends Singer , Songwriter { 


AudioClip strum () ; 


void actSensitive () ; 


o ee eT RAPE, MBE ERX, FeO tae T Re 
主 ， 能 帮助 你 解决 大 问题 。 另 外 一 种 做 法 是 编写 一 个 胱 肿 (bloated) 
的 类 层次 ， 对 于 每 一 种 要 被 文 持 的 属性 组 合 ， 都 包含 一 个 单独 的 类 。 
如 果 在 整个 类 型 系统 中 有 n 个 属性 ， 那 么 就 必须 支持 $2^ng$ 种 可 能 的 
SHE a o 这 种 现象 被 称 为 “组合 爆炸 (combinatorial explosion) ”。 类 层 
次 胱 肿 会 导致 类 也 腔 肿 ， 这 些 类 包含 许多 方法 ， 并 且 这 些 方法 只 是 在 


参数 的 类 型 上 有 所 不 同 而 已 ， 因 为 类 层次 中 没有 任何 类 型 体现 了 公共 
的 行为 特征 。 


通过 第 16 条 中 介绍 的 BEA (wrapper class) 模式 ， 蒂 订 使 得 安全 坑 
增 跑 类 所 功能 成 为 可 以 。 如 果 使 用 抽象 类 来 定义 类 型 ， 那么 程序 员 除 
了 使 用 继承 的 手段 增加 功能 ， 没 有 其 他 的 选择 。 这 样 得 到 的 类 与 包装 
类 相 比 ， 功 能 更 差 ， 也 更 加 脆弱 。 


虽然 接口 不 允许 包含 方法 的 实现 ， 但 是 ， 使 用 接口 来 定义 类 型 并 不 妨 

碍 你 为 程序 员 提 供 实现 上 的 帮助 。 eT RS AEE TS IRL abe 
HA—T THR NI FEEG (skeletal implementation) #&, Æ OMR 
HUA AER o FROME AEA, (SRR E I 

所 有 与 接口 实现 相关 的 工作 。 


按照 惯例 ， 骨架 实现 被 称 为 AbstractInterface , 这 里 的 Interface 是 指 
所 实现 的 接口 的 名 字 。 例 如 ，Collections Framework 为 每 个 重要 的 集 
合 接口 都 提供 了 一 个 骨架 实现 ， 包括 AbstractCollection 、  AbstractSet 
~  AbstractList 和 AbstractMap ° 将 他 们 称 作 SkeletalCollection ` 
SkeletalSet ~  SkeletalList 和 SkeletalMap 也 是 有 道理 的 ， 但 是 现在 
Abstract 的 用 法 已 经 根深 带 固 k 


如 果 涉 及 得 当 ， 骨 架 实 现 可 以 使 程序 员 很 容易 提供 他 们 自己 的 接口 实 
现 。 例如 , 下 面 一 个 静态 工厂 方法 ， 它 包含 一 个 完整 的 、 功 能 全 面 的 
List SEH: 


// Concrete implementation built atop skeletal implementation 


static List<Integer> intArrayAsList ( final int [] a) { 


if (a == null ) 


throw new NullPointerException(); 


return new AbstractList<Integer>() { 


public Integer get ( int i) { 


return a[i]; // Autoboxing (Item 5) 


@Override public Integer set ( int i, Integer val) { 


int oldVal = a[i]; 
a[i] = val; // Auto-unboxing 


return oldVal; // Autoboxing 


public int size () { 


return a.length; 


当 你 考虑 实现 一 个 List 实现 应 该 为 你 完成 哪些 工作 的 时 候 ， 可 以 看 
出 ， 这 个 例子 充分 演示 了 骨架 实现 的 强大 功能 。 顺 便 提 一 下 ， 这 个 例 
子 是 个 Adapter[Gamma95，Pp.139]， 它 允许 将 int 数组 看 做 Integer 

实例 的 列表 ° 由 于 在 int 值 和 Integer 实例 之 间 来 回转 化 需要 开销 ， 
它 的 性 能 不 会 很 好 。 注 意 ， 这 个 例子 中 只 提供 一 个 静态 工厂 ， 并 且 这 
个 类 还 是 个 不 可 被 访问 的 EEA (anonymous class) ”( 见 第 22 条 ) ， 
它 被 隐藏 在 静态 工厂 的 内 部 。 


骨架 实现 的 美妙 之 处 在 于 ， 它 们 为 抽象 类 提供 了 实现 上 的 帮助 ， 但 又 
不 强加 “抽象 类 被 用 作 类 型 定义 时 ”所 特有 的 严格 限制 。 对 于 接口 的 大 
多 数 实 现 来 讲 ， 扩 展 骨 和 架 实 现 类 是 个 很 显然 的 选择 ， 但 并 不 是 必需 

的 。 如 果 预 置 的 类 无 法 扩展 骨架 实现 类 ， 这 个 类 始终 可 以 手工 实现 这 
个 接口 。 此 外 ， 骨 以 实现 类 仍然 能 够 有 助 于 接口 的 实现 。 实 现 了 这 个 
接口 的 类 可 以 把 对 于 接口 方法 的 调用 ， 转 发 到 一 个 内 部 私有 类 的 实力 
上 ， 这 个 内 部 私有 类 扩展 了 骨 架 实现 类 。 这 种 方法 被 称 作 EUS BE 
7& (simulated multiple inheritance) ， 它 与 第 16 条 中 讨论 的 包装 类 模式 
oe © 这 项 技术 具有 多 重 继承 的 绝 大 多 数 优 点 ， 同 时 又 避免 了 相 
应 的 缺陷 。 


编写 骨架 实现 类 相对 比较 简单， 只 是 有 点 单调 乏味 。 首 先 ， 必 须 认 真 
研究 接口 ， 并 确定 哪些 方法 是 最 为 基本 的 (primitive) ， 其 他 的 方法 
则 可 以 根据 它们 来 实现 。 这 些 基本 方法 将 成 为 骨架 实现 类 中 的 抽象 方 
法 。 然 后 ， 必 须 为 接口 中 所 有 其 他 的 方法 提供 具体 的 实现 。 例 如 ， 下 
面 是 map.entry 接口 的 骨架 实现 类 : 


// Skeletal Implementation 


public abstract class AbstractMapEntry <K, V> 


implements Map . Entry <K, V> { 


// Primitive operations 


public abstract K getKey () ; 


public abstract V getValue () ; 


// Entries in modifiable maps must override this method 


public V setValue (V value) { 


throw new UnsupportedOperationException(); 


// Implements the general contract of Map.Entry.equals 


@Override public boolean equals (Object o) { 


if (0 == this ) 


return true ; 


if (! (o instanceof Map.Entry)) 


return false ; 


Map.Entry<?, ?> arg = (Map.Entry) 0; 


return equals(getKey(), arg.getKey()) && 


equals(getValue(), arg.getValue()); 


private static boolean equals (Object 01, Object 02) 


return 01 == null ? 02 == null : o1.equals(o2); 


// Implements the general contract of Map.Entry.hashCode 


@Override public int hashCode () { 


return hashCode(getKey()) ^ hashCode(getValue()); 


private static int hashCode (Object obj) { 


return obj == null ? © : obj.hashCode(); 


因为 骨架 实现 类 是 为 了 继承 的 目的 而 设计 的 ， 所 以 应 该 遵从 第 17 条 中 
介绍 的 所 有 关于 设计 和 文档 的 知道 原则 。 为 了 简短 起 见 ， 上 面 例子 中 
的 文档 注释 部 分 被 省 略 掉 了 ， 但 是 对 于 骨架 实现 类 而 言 ， 好 的 文档 绝 
对 是 非常 必要 的 。 


骨架 实现 上 有 个 小 小 的 不 同 ， 就 是 AAEH (simple implementation) 
,  Abstractap.Simpleentry 就 是 个 例子 。 简 单 实现 就 像 个 骨架 实现 ， 这 
是 因为 它 实现 了 接口 ， 并 且 是 为 了 继承 而 设计 的 ， 但 是 区 别 在 于 它 不 
是 抽象 的 : 它 是 最 简单 的 可 能 的 有 效 实现 。 你 可 以 原封 不 动 地 使 用 ， 
也 可 以 看 情况 将 它 子 类 化 。 


使 用 抽象 类 来 定义 允许 多 个 实现 的 类 型 ， 与 使 用 接口 相 比 有 一 个 明显 
的 优势 : RAAB IOIA RADE ° WREEK ÍT 
版 本 中 ， 你 希望 在 抽象 类 中 增加 新 的 方法 ， 始 终 可 以 增加 具体 方法 ， 

它 包含 合理 的 默认 实现 。 然 后 ， 该 抽象 类 的 所 有 现 有 实现 都 将 提供 这 
个 新 的 方法 。 对 于 接口 ， 这 样 做 是 行 不 通 的 。 


一 般 来 说 ， 要 想 在 公有 接口 中 增加 方法 ， 而 不 破坏 实现 这 个 接口 的 所 
有 现 有 的 类 ， 这 古 不 可 能 的 。 之 前 实现 该 接口 的 类 将 会 着 挥 新 增加 的 
方法 ， 并 且 无 法 再 通过 编译 。 在 为 接口 增加 新 方法 的 同时 ， 也 为 骨架 
实现 类 增加 同样 的 新 方法 ， 这 样 可 以 在 一 定 程 度 上 减 小 由 此 市 来 的 破 


坏 ， 但 是 ， 这 样 做 并 没有 真正 解决 问题 。 所 有 不 从 骨 织 实现 类 继承 的 
接口 实现 仍然 会 遭 到 破坏 。 


因此 ， 设 计 公有 的 接口 要 非常 谍 愤 。 RO-ARAARIT, HAER 
STEM, ARKEOL PET RERI o VRID AEM IIIT 
HRDLE O EE ° WR BS VBE, ERS — Ba 
WR DA Ree OA Ao WRRORA BR, ET DAS BCA PITHY) 
RRK ° ERITI OIR, BANE, TERR RZ 
前 ， 尽 可 能 让 更 多 的 程序 员 用 尽 可 能 多 的 方式 来 实现 这 个 新 接口 。 这 
样 有 助 于 在 依然 可 以 改正 缺陷 的 时 候 就 发 现 它们 。 


简 而 言 之 ， 接 口 通常 是 定义 允许 多 个 实现 的 类 型 的 最 佳 途径 。 这 条 规 
则 有 个 例外 ， 即 当 演变 的 容易 性 比 灵活 性 和 功能 更 为 重要 的 时 候 。 在 
这 种 情况 下 ， 应 该 使 用 抽象 类 来 定义 类 型 ， 但 前 提 十 必须 理解 并 且 可 
以 接受 这 些 局 限 性 。 如 采 你 导出 了 一 个 重要 的 接口 ， 丈 应 该 坚决 考虑 
同时 提供 骨架 实现 类 。 最 后 ， 应 该 尽 可 能 谍 慎 地 设计 所 有 的 公有 接 
口 ， 并 通过 编写 多 个 实现 来 对 它们 进行 全 面 的 测试 。 


第 19 条 : 接口 只 用 于 定义 类 型 


当 类 实现 接口 时 ， 接 口 就 充当 可 以 引用 这 个 类 的 实例 的 闫 型 (type) 
o 因此， 类 实现 了 接口 ， 束 表明 客户 问 可 以 对 这 个 类 的 实例 实施 茶 些 
动作 。 为 了 任何 其 他 目的 而 定义 接口 是 不 恰当 的 。 


有 一 种 接口 被 称 为 KALO (constant interface) ， 它 不 满足 上 面 的 
条 件 。 这 种 接口 没有 包含 任何 方法 ， 它 只 包含 静态 的 final 域 ， 每 个 
域 都 导出 一 个 常量 。 使 用 这 些 常 量 的 类 实现 这 个 接口 ， 以 避免 用 类 名 
来 修饰 常量 名 。 下 面 是 一 个 例子 : 


// Constant interface antipattern - do not use! 


public interface PhysicalConstants { 


// Avogadro's number (1/mol) 


static final double AVOGADROS_NUMBER = 6.02214199e23 ; 


// Boltzmann constant (J/K) 


static final double BOLTZMANN_CONSTANT = 1.3806503e-23 ; 


// Mass of the electron (kg) 


static final double ELECTRON_MASS = 9.10938188e-31 ; 


访 重 接口 模式 十 对 授 口 的 不 恨 合 用。 类 在 内 部 使 用 某 些 常 量 ， 这 纯粹 
苹 实 现 细 亡 。 实 现 第 量 接 口 ， 会 导致 把 这 样 的 实现 细节 沪 露 到 该 类 导 
出 的 API 中 。 类 实现 常量 接口 ， 这 对 于 这 个 类 的 用 户 来 讲 没 有 什么 价 
值 。 实 际 上 ， 这 样 做 反而 会 使 他 们 更 加 糊涂 。 更 糟糕 的 是 ， 它 代表 了 
一 种 承诺 :如果 在 将 来 的 发 行 版 本 中 ， 这 个 类 被 修改 了 ， 它 不 再 需要 
使 用 这 些 常量 了 ， 它 依然 必须 实现 这 个 接口 ， 以 确保 二 进 制 兼容 性 。 
如 果 非 final 类 实现 了 常量 接口 ， 它 的 所 有 子 类 的 命名 空间 也 会 被 接 
口中 的 常量 所 “污染 ”。 


在 Java 平 台 类 库 中 有 几 个 音量 接口 ， 例如 Javasionobjectstreamconstants 
0 这 些 接口 应 该 被 认为 是 反面 的 典型 ， 不 值得 效仿 。 


如 果 要 导出 常量 ， 可 以 有 几 种 合理 的 选择 方案 。 如 果 这 些 常量 与 某 个 
现 有 的 类 或 者 接口 紧密 相关 ， 就 应 该 把 这 些 常量 添加 到 这 个 类 或 者 接 
口中 。 例 如 ， 在 Java 平 台 类 库 中 所 有 的 数值 包装 类 ， 如 integer 和 
Double ， 都 导出 了 mm vave 和 max_vatue 常量 。 如 果 这 些 稼 量 最 好 被 
看 作 枚 举 类 型 的 成 员 ， 就 应 该 使 用 KAKE (enum type) (W30 
条 ) 来 导出 这 些 常 量 。 否 则 ， 应 该 使 用 不 可 实例 化 的 工具 类 (utility 
class) ”( 见 第 4 条 ) 来 导出 这 些 常量 。 下 面 的 例子 是 前 面 的 
PhysicalConstants 例子 的 工具 类 翻版 : 


// Constant utility class 


package com.effectivejava.science; 


public class PhysicalConstants { 


private PhysicalConstants () { } // Prevents instantiation 


public static final double AVOGADROS_NUMBER = 6.02214199e23 ; 


public static final double BOLTZMANN_CONSTANT = 1.3806503e-23 ; 


public static final double ELECTRON_MASS = 9.10938188e-31 ; 


工具 类 通常 要 求 客 户 病 要 用 类 名 来 修饰 这 些 常量 名 ， 例 如 
PhysicalConstants.AVOGADROS_NUMBER R 如 果 大 量 利 用 工具 类 导出 的 常量 ， 可 
以 通过 利用 FAA-GLA (static import) 机 制 ， 避 免 用 类 名 来 修饰 常量 
A, 不过， 静态 导入 机 制 是 在 Java 发 行 版 本 1.5 中 才 引 入 的 : 


// Use of static import to avoid qualifying constants 


import static com.effectivejava.science.PhysicalConstants.*; 


public class Test { 
double atoms ( double mols) { 


return AVOGADROS_NUMBER * mols; 


// Many more uses of PhysicalConstants justify import 


AMEL, ROMA RRR RE RAE, EMA ABR h h 


第 20 条 : 类 层次 优 于 标签 类 


有 时 候 ， 可 能 会 过 到 市 有 两 种 甚至 更 多 种 风格 的 实例 的 类 ， 并 包含 表 
示 实 例 风格 的 HE (tag) 域 。 例 如 ， 考 虑 下 面 这 个 类 ， 它 能 够 表示 
[Bal Fe Be FETE 


// Tagged class - vastly inferior to a class hierarchy 


class Figure { 


enum Shape { RECTANGLE, CIRCLE}; 


// Tag field - the shape of this figure 


final Shape shape; 


// These fields are used only if shape is RECTANGLE 


double length; 


double width; 


// This field is used only if shape is CIRCLE 


double radius; 


// Constructor for circle 


Figure( double radius) { 


shape = Shape.CIRCLE; 


this .radius = radius; 


// Constructor for rectangle 


Figure( double length, double width) { 


shape = Shape.RECTANGLE; 


this .length = length; 


this .width = width; 


double area () { 


switch (shape) { 


case RECTANGLE: 


return length * width; 


case CIRCLE: 


return Math.PI * (radius * radius); 


default : 


throw new AssertionError(); 


这 种 PPE (tagged class) 有 着 许多 缺点 。 它 们 中 充斥 着 样板 代码 ， 
包括 枚 举 声 明 、 标 签 域 以 及 条 件 语句 。 由 于 多 个 实现 乱七八糟 地 挤 在 
了 单个 类 中 ， 破 坏 了 可 读 性 。 内 存 占 用 也 增加 了 ， 因 为 实例 承担 着 属 
于 其 他 风格 的 不 相关 的 域 。 域 不 能 做 成 是 final AY, BRIERE AER 
化 了 不 相关 的 域 ， 产生 更 多 的 样板 代码 。 构 造 絮 必须 不 借助 编译 絮 ， 
来 设置 标签 域 ， 并 初始 化 正确 的 数据 域 ， 如 果 初 始 化 了 错误 的 域 ， 程 
序 就 会 在 运行 时 失败 。 无 法 给 标签 类 添加 风格 ， 除 非 可 以 修改 它 的 源 
文件 。 如 果 一 定 要 添加 风格 ， 束 必须 级 的 给 每 个 条 件 语 句 都 添加 一 个 
条 件 ， 否 则 类 就 会 在 运行 时 失败 。 最 后 ， 实 例 的 数据 类 型 没有 提供 任 
何 关 于 其 风格 的 线索 。 一 句 话 ， MEATPITR: BAH, FAB 
KEF ° 

邓 运 的 是 ， 面 向 对 象 的 语言 例如 Java， 就 提供 了 其 他 更 好 的 方法 来 定 


义 能 够 表示 多 种 风格 对 象 的 单个 数据 类 型 ， 字 类 型 化 (subtyping) 。 
PER EAA A PT TL < 


Aan 为 类 层次 ， 首 先 要 为 标签 类 中 的 每 个 方法 都 定义 一 
含 抽象 方法 的 抽象 类 ， 这 每 个 方法 的 行为 都 依赖 于 标签 值 。 在 
Figure 类 中 ， 上 5 上 只 有 一 个 这 样 的 方法 area 。 这 个 抽象 类 是 类 层次 的 
根 (root) 。 如 果 还 有 其 他 的 广 法 其 行为 不 依赖 于 标签 的 值 ， 丈 把 这 
样 的 方法 放 在 这 个 类 中 。 同 样 地 ， 如 果 所 有 的 方法 都 用 到 了 某 些 数 据 
域 ， 就 应 该 把 它们 放 在 这 个 类 中 。 在 Fioure 类 中 ， 不 存在 这 种 类 型 独 
并 的 方法 或 者 数据 域 。 
接 下 来 ， 为 每 种 原始 标签 类 都 定义 根 类 的 具体 子 类 。 在 前 面 的 例子 
中 ， 这 样 的 类 型 有 两 个 : 圆 形 (circle) MEJA! (rectangle) 。 在 每 个 
子 类 中 都 包含 特定 于 该 类 型 的 数据 域 。 在 我 们 的 示例 中 ， radius 是 特 
定 于 圆 形 的 ， lengtn 和 width 是 特定 于 矩形 的 。 同 时 在 每 个 子 类 中 
还 包括 针对 根 类 中 每 个 抽象 方法 的 相应 实现 。 以 下 是 与 原始 的 Figure 
类 相对 应 的 类 层次 : 


abstract class Figure { 


abstract double area () ; 


class Circle extends Figure { 


final double radius; 


Circle( double radius) { this .radius = radius; } 


double area () { return Math.PI * (radius * radius); } 


class Rectangle extends Figure { 


final double length; 


final double width; 


Rectangle( double length, double width) { 


this .length = length; 


this .width = width; 


double area () { return length * width; } 


这 个 类 层次 纠正 了 前 面 提 到 过 的 标签 类 的 所 有 缺点 。 这 段 代 码 简 单 且 
清楚 ， 没 有 包含 在 原来 的 版 本 中 所 见 到 的 所 有 样板 代码 。 每 个 类 型 的 
实现 都 配 有 目 己 的 类 ， 这 些 类 都 没有 受到 不 相关 的 数据 域 的 拖 素 。 所 
有 的 域 都 是 final 的 。 编 译 硕 确保 每 个 类 的 构造 器 都 初始 化 了 它 的 数 
据 域 ， 对 于 根 类 中 声明 的 每 个 抽象 方法 ， 都 确 休 有 一 个 实现 。 这 样 束 
杜绝 了 由 于 遗漏 switch case 而 导致 运行 时 失败 的 可 能 性 。 多 个 程序 员 
可 以 独立 地 扩展 层次 结构 ， 并 且 不 用 访问 根 类 的 源 代 码 残 能 相互 操 
作 。 每 种 类 型 都 有 一 种 相关 的 独立 的 数据 类 型 ， 人 允许 程序 员 指 明 变 量 
的 类 型 ， 限 制 变量 ， 并 将 参数 输入 到 特殊 的 类 型 。 


类 层次 的 男 一 种 好 处 在 于 ， 它 们 可 以 用 来 反映 类 型 之 间 本 质 上 的 层次 
关系 ， 有 助 于 增强 灵活 性 ， 并 进行 更 好 的 编译 时 类 型 检查 。 假 设 上 述 
例子 中 的 标签 类 也 人 允许 表达 正方 形 。 类 层次 可 以 反映 出 正方 形 也 是 一 
种 特殊 的 矩形 这 一 事实 (假设 两 者 都 是 不 可 变 的 ) : 

class Square extends Rectangle { 


Square( double side) { 


super (side, side); 


注意 ， 上 述 层次 中 的 域 是 被 直接 访问 ， 而 不 是 通过 访问 方法 。 这 是 为 
了 简洁 起 见 才 这 么 做 的 ， 如 果 层 次 结构 是 公有 的 〈 见 第 14 条 ) ， 则 不 
允许 这 样 做 。 


简 而 言 之 ， 标 和 俭 类 很 少 有 适用 的 时 候 。 当 你 想 妥 编写 一 个 包含 显 式 标 
签 域 的 类 时 ， 应 该 考虑 一 下 ， 这 个 标签 是 否 可 以 被 取消 ， 这 个 类 是 否 
可 以 用 类 层次 来 代替 。 当 你 遇 到 一 个 包 人 对 标签 域 的 现 有 类 时 ， 融 要 考 
虑 将 它 重 构 到 一 个 层次 结构 中 去 。 


第 21 条 : 用 画 数 对 象 表示 策略 


有 些 语言 支持 ZCFSFP (function pointer) ` {E (delegate) ` 

lambda ziS zt (lambda expression) ， 或 者 文 持 类 似 的 机 制 ， 人 允许 程 
序 把 “调用 特殊 函数 的 能 力 ” 存 储 起 来 并 传递 这 种 的 能 力 。 这 种 机 制 通 
常 允 许 函 数 的 调用 者 通过 传 入 第 二 个 函数 ， 来 指定 自己 的 行为 。 例 

如 ，C 语 言 标准 库 中 的 qsort 范 数 要 求 用 一 个 指向 comparator (LF 
ar) 函数 的 指针 作为 参数 ， 它 用 这 个 函数 来 比较 竺 排序 的 元 素 。 比 较 
右 函 数 有 两 个 参数 ， 都 是 指 癌 元 素 的 指针 。 如 果 第 一 个 参数 所 指 的 元 
系 小 于 第 二 个 参数 所 指 的 元 素 ， 则 返回 一 个 负 整 数 ， 如 果 两 个 元 素 相 
等 则 返回 零 ， 如 有 果 第 一 个 参数 所 指 的 元 素 大 于 第 二 个 参数 所 指 的 元 

率 ， 则 返回 一 个 正 整 数 。 通 过 传递 不 同 的 比较 器 函数 ， 残 可 以 获得 各 


种 不 同 的 排列 顺序 。 这 正 是 策略 (Strategy) 模式 [Gamma，p.315] 的 一 
个 例子 。 比 较 絮 函数 代表 一 种 为 元 素 排 序 的 策略 。 


Java 没 有 提供 函数 指针 ， 但 十 可 以 用 对 象 引 用 实现 同样 的 功能 。 调 用 
对 象 上 的 方法 通常 是 执行 ZXR (that object) 上 的 茶 项 操作 。 然 
而 ， 我 们 也 可 能 定义 这 样 一 种 对 象 ， 它 的 方法 执行 AXIR (other 
objects) 这些 对 象 被 显 式 传递 给 这 些 方 法 ) 上 的 操作 。 如 果 一 个 类 
仅仅 导出 这 样 的 一 个 方法 ， 它 的 实例 实际 上 束 等 同 于 一 个 指 同 该 方法 
HZOTE (function object) 。 例 如 ， 考 虑 


class StringLengthComparator { 
public int compare (String s1, String s2) { 


return si.length() - s2.length(); 


这 个 类 导出 一 个 带 两 个 字符 串 参数 的 方法 ， 如 果 第 一 个 字符 串 的 长 度 
比 第 二 个 的 短 ， 则 返回 一 个 负 整 数 ， 如 有 果 两 个 字符 串 的 长 度 相等 ， 则 
返回 零 ， 如 果 第 一 个 字符 串 比 第 二 个 的 长 ， 则 放 回 一 个 正 整 数 。 这 个 
方法 是 一 个 比较 器 ， 它 根据 长 度 来 给 字符 串 排序 ， 而 不 是 根据 更 常用 
的 字典 顺序 2 指 问 StringLengthComparator 对 象 的 引用 可 以 被 当 作 是 一 个 
指 回 该 比较 器 的 “函数 指针 (function pointer) ”， 可 以 在 任意 一 对 字符 
串 上 被 调用 换 句 话说 ， StringLengthComparator 实例 是 用 于 字符 串 比 较 
操作 的 ARIE (concrete strategy) 


作为 典型 的 具体 策略 类 ， StringLengthComparator 类 是 EIKKI 

(stateless) : 它 没有 域 ， 所 以 ， 这 个 类 的 所 有 实例 在 功能 上 都 是 相 
互 等 价 的 。 因 此 ， 它 作为 一 个 Singleton 是 非常 合适 的 ， 可 以 节省 不 必 
要 的 对 象 创建 开销 ( 见 第 3 条 和 第 5 条 ) : 


class StringLengthComparator { 


private StringLengthComparator () { } 

public static final StringLengthComparator 
INSTANCE = new StringLengthComparator(); 

public int compare (String s1, String s2) { 


return si.length() - s2.length(); 


为 了 把 stringtengthcomparator 实例 传递 给 方法 ， 需 要 适当 的 参数 类 型 。 
使 用 stringtengthcomparator 并 不 好 ， 因 为 客户 并 将 无 法 传递 任何 其 他 的 
比较 案 略 。 相 反 ， 我 们 需要 定义 一 个 Comparator 接口 ， 并 修改 
stringLengthcomparator 来 实现 这 个 接口 。 换 句 话 说， 我 们 在 设计 具体 的 
策略 类 时 ， 还 需要 定义 一 个 RIELO (strategy interface) ， 如 下 所 
JN: 


// Strategy interface 
public interface Comparator < T> { 


public int compare (T t1, T t2) ; 


Comparator 接口 的 这 个 定义 碰巧 也 出 现在 java.vtit 包 中 ， 但 是 这 并 不 
神奇 ; 你 目 己 也 完全 可 以 定义 它 。 Comparator 接口 是 这 型 ( 见 第 26 
R) 的 ， 因 此 它 适合 作为 除 字符 串 之 外 的 其 他 对 象 的 比较 器 。 它 的 
compare 方法 的 两 个 参数 类 型 为 1 (E ERAKAR) ， 而 不 是 
String 只 要 前 面 所 示 的 StringLengthComparator 类 要 这 么 做 ， 就 可 以 用 


它 实 现 Comparator<String> 接口 ; 


class StringLengthComparator implements Comparator < String > { 


. // class body is identical to the one shown above 


具体 的 策略 类 往往 使 用 匿名 类 声明 ( 见 第 22 条 ) 。 下 面 的 语句 根据 长 
度 对 一 个 字符 串 数 组 进行 排序 : 


Arrays.sort(stringArray, new Comparator<String>() { 
public int compare (String s1, String s2) { 


return si.length() - s2.length(); 


但 是 注意 ， 以 这 种 方式 使 用 匿名 类 时 ， 将 会 在 每 次 执行 调用 的 时 候 创 
建 一 个 新 的 实例 。 如 采 它 被 重复 执行 ， 考 虑 将 函数 对 象 存储 到 一 个 私 
有 的 静 仿 tina 域 里 ， 并 重用 它 。 这 样 做 的 男 一 种 好 处 是 ， 可 以 为 这 
个 函数 对 象 取 一 个 有 意义 的 域名 称 。 


因为 策略 接口 被 用 作 所 有 具体 策略 实例 的 类 型 ， 所 以 我 们 并 不 需要 为 
了 导出 具体 策略 ， 而 把 具体 策略 类 做 成 公有 的 。 相 反 ,，“ 笨 主 类 (host 
class) ”还 可 以 导出 公有 的 静态 域 《或 者 静态 工厂 方法 ) ， 其 类 型 为 策 
略 接口 ， 上 基体 的 策略 类 可 以 是 竹 主 类 的 私有 藤 套 类 。 下 面 的 例子 使 用 
静态 成 员 类 ， 而 不 是 匿名 类 ， 以 便 允 许 具体 的 策略 类 实现 第 二 个 接口 


Serializable : 


// Exporting a concrete strategy 


class Host { 


private static class StrLenCmp 


implements Comparator < String >, Serializable { 
public int compare (String si, String s2) { 


return si.length() - s2.length(); 


// Returned comparator is serializable 
public static final Comparator<String> 


STRING_LENGTH_COMPARATOR = new StrLenCmp(); 


// Bulk of class omitted 


string 类 利用 这 种 模式 ， 通 过 它 的 casE_ItNsENsITIVE_oRDER 域 ， 导 出 一 个 
不 区 分 大 小 写 的 字符 串 比 较 器 。 


简 而 言 之 ， 画 数 指针 的 主要 用 途 就 是 实现 策略 (Strategy) 模式 。 为 了 
在 Java 中 实现 这 种 模式 ， 要 声明 一 个 接口 来 表示 该 策略 ， 并 且 为 每 个 
具体 策略 声明 一 个 实现 了 该 接口 的 类 。 当 一 个 具体 策略 只 被 使 用 一 次 
时 ， 通 常 使 用 匿名 类 来 声明 和 实例 化 这 个 具体 策略 类 。 当 一 个 具体 策 
略 类 是 设计 用 来 重复 使 用 的 时 候 ， 它 的 类 通常 就 要 被 实现 为 取 有 的 静 
态 成 员 类 ， 并 通过 公有 的 静态 na 域 被 导出 ， 其 类 型 为 该 策略 接 

O o 


第 22 条 : 优先 考虑 静态 成 员 类 


HES (nested class) 是 指 被 定义 在 男 一 个 类 的 内 部 的 类 。 崩 套 类 存 
在 的 目的 应 该 只 是 为 它 的 外 围 类 (enclosing class) HEERS ° WRA 
套 类 姜 凯 可 能 会 用 于 其 他 的 某 个 环境 中 ， 它 就 应 该 是 顶层 类 (top- 
level class) ° RERE U: HAA (static member class) 
HRPE (nonstatic member class) ` 2% (anonymous 
class) 和 局 部 类 (local class) 。 除 了 第 一 种 之 外 ， 其 他 三 种 都 被 称 
为 内 部 类 (inner class) 。 本 条 目 将 告诉 你 什么 时 候 应 该 使 用 哪 种 符 
套 类 ， 以 及 这 样 做 的 原因 。 


静 仿 成 员 类 十 最 简单 的 一 种 藤 套 类 。 最 好 把 他 看 作 古 普通 的 类 ， 只 是 
碰巧 被 声明 在 另 一 个 类 的 内 部 而 已 ， 它 可 以 方位 外 围 类 的 所 有 成 员 ， 
包括 那些 声明 为 私有 的 成 员 。 静 态 成 员 类 是 外 围 类 的 一 个 静态 成 员 ， 
与 其 他 静 仿 成 员 一 样 ， 也 遵守 同样 的 可 访问 性 规则 。 如 有 果 它 个 声 明 为 
私有 的 ， 它 整 只 能 在 外 围 类 的 内 部 才 可 以 被 访问 ， 等 等 。 


静态 成 员 类 的 一 种 营 见 用 法 是 作为 公有 的 辅助 类 ， 仅 当 与 它 的 外 部 类 
一 起 使 用 时 才 有 意义 。 例 如 ， 考 虑 一 个 枚 举 ， 它 描述 了 计算 吉文 持 的 
各 种 操作 〈 见 第 30 条 ) ° operation 枚 举 应 该 是 calculator 类 的 公有 静 
态 成 员 ， 然后 ， Calculator 类 的 客户 问 束 可 以 用 诸如 

Calculator .Operation.PLUS 和 Calculator .Operation.MINUS 这 样 的 名 称 来 引用 

这 些 操作 。 


SAS EG, FRANCA SAAR ARS Be SZ AEA lle, BRAS 
员 类 的 声明 中 包含 修饰 符 static 。 尽 管 它们 的 语法 非常 相似 ， 但 是 这 
两 种 骨 套 类 有 很 大 的 不 同 。 非 静态 成 员 类 的 每 个 实例 都 隐 含 着 与 外 转 
类 的 一 个 外 万 笑 倪 (enclosing instance) 相关 联 。 在 非 静态 成 员 类 的 

实例 方法 内 部 ， 可 以 调用 外 围 实例 上 的 方法 ， 或 者 利用 修饰 过 的 this 
构造 获得 外 围 实例 的 引用 [JLS，15.8.4]。 如果 椒 套 类 的 实例 可 以 在 它 

外 于 类 的 实例 之 外 独立 存在 ， 这 个 代 父 类 融 必 须 是 静态 成 员 类 : 在 没 
有 外 围 实例 的 情况 下 ， 要 想 创建 非 静态 成 员 类 的 实例 是 不 可 能 的 。 


当 非 静态 成 员 类 的 实例 被 创建 的 时 候 ， 它 和 外 围 实例 之 前 的 关联 天 系 
也 随 之 被 建立 起 来 而且， 这 种 关联 关系 以 后 不 能 被 修改 。 通 常情 况 
下 ， 当 在 外 围 类 的 某 个 实例 方法 的 内 部 调用 非 静 态 成 原来 的 构造 如 
时 ， 这 种 关联 关系 被 目 动 建立 起 来 5 使 用 表达 式 enclosingInstance.new 


MemberClass(args) 来 手工 建立 这 种 关联 关系 也 是 有 可 能 的 ， 但 是 很 少 使 
用 。 正 如 你 所 预料 的 那样 ， 这 种 关联 关系 需要 消耗 非 静态 成 员 类 实例 
的 空间 ， 并 且 增 加 了 构造 的 时 间 开 销 。 


韭 静态 成 员 类 的 一 种 常见 用 法 是 定义 一 个 Adapterp[Gamma95， 

p.139]， 它 允许 外 部 类 的 实例 被 看 作 是 男 一 个 不 相关 的 类 的 实例 。 例 

如 ， wap 接口 的 实现 往往 使 用 非 静 态 成 员 类 来 实现 它们 的 BAMA 
(collection view) ; 这 些 集合 视图 是 由 Map 的 keySet `~ entrySet 和 
values 方法 返回 的 ‘J 同样 地 ， 诸如 set 和 List 这 种 集合 接口 的 实现 

往往 也 使 用 非 静 态 成 员 类 来 实现 它们 的 迭代 器 (iterator) : 


// Typical use of a nonstatic member class 


public class MySet < E > extends AbstractSet < E > { 


// bulk of the class omitted 


public Iterator<E> iterator () { 


reteurn new MylIterator () ; 


private class MyIterator implements Iterator <E> { 


WR ARP BER TAIL, BEATE static MEITE 
EKÆBAF, SE MARA RAR, MAAR ARC ° WRA 
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圾 回收 〈 见 第 6 条 ) 时 却 仍然 得 以 保留 。 如 有 果 在 没有 外 围 实 例 的 情况 
下 ， 也 需要 分 配 实 例 ， 束 不 能 使 用 非 静 仿 成 员 类 ， 因 为 非 静态 成 员 类 
的 实例 必须 要 有 一 个 外 围 实 例 。 


私有 静 态 成 员 类 的 一 种 常见 用 法 是 用 来 代替 外 围 类 所 代表 的 对 象 的 组 
件 。 例 如 ， 考 虑 一 个 map 实例 ， 它 把 键 (key) 和 值 (value) 关联 起 
来 。 许 多 mp 实现 的 内 部 都 有 一 个 entry 对 象 ， 对 应 于 map 中 每 个 
键 - 值 对 。 虽 然 每 个 entry 都 与 一 个 map 关联 ， 但 是 entry 上 的 方法 ( 

getKey ` getvalue 和 setValue ) 并 不 需要 访问 该 Map ° 因此 ， 使 用 
非 静 态 成 员 来 表示 entry 是 很 浪费 的 ， 私 有 的 静态 成 员 类 是 最 佳 的 选 

择 。 如 果 不 小 心 漏 掉 了 entry 声明 中 的 static 修饰 符 ， 该 map 仍然 可 
以 工作 ， 但 是 每 个 entry 中 将 会 包含 一 个 指向 该 map 的 引用 ， 这 样 就 
浪费 了 空间 和 时 间 。 


如 采 相 关 的 类 是 导出 类 的 共有 的 或 受 傈 护 的 成 员 ， 盈 无 疑问 ， 在 静态 
和 非 静 仿 成 员 类 之 间 做 出 正确 的 选择 是 非常 重要 的 。 在 这 种 情况 下 ， 

该 成 员 类 就 是 导出 的 API 元 素 ， 在 后 续 的 发 行 版 本 中 ， 如 琳 不 违反 二 
进 制 兼容 性 ， 束 不 能 从 非 静 仿 成 员 类 变 为 静态 成员 类 。 


匿名 类 不 同 于 Java 程 序 设计 语言 中 的 其 他 任何 语法 单元 。 正 如 你 所 想 
象 的 ， 匿 名 类 没有 名 字 。 它 不 是 外 围 类 的 一 个 成 员 。 它 并 不 与 其 他 的 
成 员 一 起 被 声明 ， 而 是 在 使 用 的 同时 被 声明 和 实例 化 。 匿 名 类 可 以 出 
现在 代码 中 任何 允许 存在 表达 式 的 地 方 。 当 且 仅 当 匿 名 类 出 现在 非 静 
仿 的 环境 中 时 ， 它 才 有 人 外围 实 例 。 但 是 即使 它们 出 现在 静态 的 环境 
中 ， 也 不 可 能 拥有 任何 静态 成 员 。 


匿名 类 的 适用 性 受到 诸多 的 限制 。 除 了 在 它们 被 声明 的 时 候 之 外 ， 是 

无 法 将 它们 实例 化 的 。 你 不 能 执行 instanceof 而 是 ， 或 者 做 任何 需要 

命名 类 的 其 他 事情 。 你 无 法 声明 一 个 匿名 类 来 实现 多 个 借口 ， 或 者 扩 

展 一 个 类 ， 并 同时 扩展 类 和 实现 接口 。 匿 名 类 的 客户 端 无 法 调用 任何 

成 员 ， 除 了 从 它 的 超 类 型 中 继承 得 到 之 外 。 由 于 匿名 类 出 现在 表达 式 
大 约 10 行 或 者 更 少 些 一 否则 会 影响 程序 
JASE © 


匿名 类 的 一 种 常见 用 法 是 动态 地 创建 BATE (function object, W 
第 21 条 。 例 如 ， 第 92 页 中 的 sore 方法 调用 ， 利 用 匿名 的 comparator 
实例 ， 根 据 一 组 字符 串 的 长 度 对 它们 进行 裴 请 。 匿 名 类 的 男 一 种 常见 
用 法 是 创建 TREXTR (process object) ; 比如 Runnable `~ Thread 或 
者 timetask 实例 。 第 三 种 常见 的 用 法 是 在 静态 工厂 方法 的 内 部 (参见 
第 18 条 中 的 intArrayAsList 方法 ) 2 
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地 方 ， 都 可 以 声明 局 部 类 ， 并 且 局 部 类 也 遵守 同样 的 作用 域 规 则 。 局 
部 类 与 其 他 三 种 谷 套 类 中 的 每 一 种 都 有 一 些 共 同 的 属性 。 与 成 员 类 一 
样 ， 局 部 类 有 名 字 ， 可 以 被 重复 地 使 用 。 与 匿名 类 一 样 ， 只 有 当局 部 
类 实在 非 静态 环境 中 定义 的 时 候 ， 才 有 外 围 实 例 ， 它 们 也 不 能 包含 静 
aa 它们 必须 非常 简短 ， 以 便 不 会 影响 到 可 读 


简 而 言 之 ， 共 有 四 种 不 同 的 骨 套 类 ， 每 一 种 都 有 目 己 的 用 途 。 如 采 一 
个 骨 套 类 需要 在 单个 方法 之 外 仍然 是 可 见 的 ， 或 者 太 长 了 ， 不 适合 

放 在 方法 内 部 ， 束 应 该 使 用 成 员 类 。 如 末 成 员 类 的 每 个 实例 都 需要 一 
个 指 回 其 外 围 实例 的 引用 ， 束 要 把 成 员 类 做 成 非 静 态 的 ; 否则 ， 丈 做 
成 静 仿 的 。 假 设 这 个 嵌 套 类 属于 一 个 方法 的 内 部 ， 如 采 你 只 需要 在 一 
个 地 方 创建 实例 ， 并 且 已 经 有 了 一 个 预 置 的 类 型 可 以 说 明 这 个 类 的 特 
征 ， 束 要 把 它 做 成 匿名 类 ;否则 ， 玖 做 成 局 部 类 。 


第 5 章 泛 型 


Java 1.5 发 行 版 本 中 增加 了 2z2 (Generic) 。 在 没有 泛 型 之 前 ， 从 集 
合 中 读 取 到 的 每 一 个 对 象 都 必须 进行 转换 。 如 果 有 人 不 小 心 插 入 了 类 
型 销 误 的 对 象 ， 在 运行 时 的 转换 处 理 残 会 出 销 。 有 了 泛 型 之 后 ， 可 以 
告诉 编译 需 每 个 集合 中 接受 哪些 对 象 类 型 。 编 译 硕 目 动 地 为 你 的 插入 
进行 转化 ， 并 在 编译 时 告知 是 否 插入 了 类 型 错误 的 对 象 。 这 样 可 以 使 
程序 既 更 加 安全 ， 也 更 加 清楚 ， 但 是 要 享有 这 些 优 势 有 一 定 的 难度 。 
本 章 就 是 教 你 如 何 最 大 限度 地 享有 这 些 优势 ， 又 能 使 整个 过 程 尽 可 能 
地 简单 化 。 有 关 这 部 分 内 容 的 详情 ， 请 参见 Langer 的 教程 

[Langer08]， 或 者 Naftalin 和 Walder 合 著 的 书 [Naftalin07]。 


第 23 条 : 请 不 要 在 新 代码 中 使 用 原生 
态 类 型 


先 来 介绍 一 些 术语 。 声 明 中 具有 一 个 或 者 多 个 类 型 参数 (type 
parameter) 的 类 或 者 接口 ， 就 是 ZÆ Generic) 类 或 者 接口 [JLS， 
8.1.2，9.1.2]。 例 如 ， 从 Java 1.5 发 行 版 本 起 ， List 接口 就 只 有 单个 类 
型 参数 E ， 表 示 列 表 的 元 素 类 型 。 从 技术 的 角度 来 看 ， 这 个 接口 的 
名 称 应 该 是 指 现在 的 Listes GRE“ e 的 列表 ”) ， 但 是 人 们 经 常 把 
它 简称 为 vist 。 泛 型 类 和 接口 统称 为 222" (generic type) 


每 种 泛 型 定义 一 组 参数 化 / 鸭 关 型 (parameterized type) ， 构 成 格式 
为 ， 显示 类 或 者 接口 的 名 称 ， 接 着 用 尖 插 号 (<> ) 把 对 应 于 泛 型 形 
式 类 型 参数 的 实际 类 型 参数 列表 [JLS，4.4，4.5] 括 起 来 。 例 如 ， 
List<string> (GRAEFF RIR) 是 一 个 参数 化 的 类 型 ， 表 示 元 素 类 
型 为 string 的 列表 。 ( string 是 与 形式 类 型 参数 e 相对 应 的 实际 
类 型 参数 。) 


EAE 


最 后 一 点 ， 每 个 泛 型 都 定义 了 一 个 REBAR (raw type) ， 即 不 带 
任何 实际 类 型 参数 的 泛 型 名 称 [JLS，4.8]。 例 如 ， 与 uist<ey> 相对 应 的 
原生 态 类 型 是 vist 。 原 生态 类 型 殴 像 从 类 型 声明 中 删除 了 所 有 泛 型 
信息 一 样 。 实 际 上 ， 原 生态 类 型 List 与 Java 平 台 没 有 泛 型 之 前 的 接 
口 类 型 List ae 


在 Java 1.5 版 本 发 行 之 前 ， 以 下 集合 声明 是 值得 参考 的 : 


aw collection type don't do this 


private final Collection stamps = ...; 


如 果 一 不 小 心 将 一 个 coin 放 进 了 stamp 集合 ， 这 一 错误 的 插入 照样 
得 以 编译 和 运行 并 且 不 会 出 现任 何 错误 提示 : 


// Erroeous insertion of coin into stamp collection 


stamps.add( new Coin(...)); 


直到 从 stamp 集合 中 获取 coin 时 才 会 收 到 错误 提示 : 
// Now a raw iterator type - don't do this! 
for (Iterator i = stamps.iterator(); i.hashNext(); ) { 
Stamp s = (Stamp) i.next(); // Throws ClassCastException 


// Do something with the stamp 


就 如 本 书 中 经 常 提 到 的 ， 出 错 之 后 应 该 尽快 发 现 ， 最 好 是 编译 时 就 发 
现 。 本 例 中 ， 直 到 代码 运行 时 才 发 现 错误 ， 已 经 出 错 很 久 了 ， 而 且 你 
在 代码 中 所 处 的 位 置 距离 包含 错误 的 这 部 分 代码 已 经 很 迄 了 。 一 旦 发 
现 ClassCastException , 了 驶 必须 搜索 代码 ， 查找 将 coin 放 进 stamp 集合 
的 方法 调用 。 此 时 编译 局 帮 不 上 忙 ， 因 为 它 无 法 理解 这 种 注 


释 : “Contains only Stamp instances (只 包含 stamp 实例 ) ”。 


ATÆ, BLE] DUAL A Botte RA E RRE RA PIER , 
告诉 编译 器 之 前 的 注释 中 所 隐 含 的 信息 : 


// Parameterized collection type - typesafe 


private final Collection<Stamp> stamps =... ; 


TEIN, mE stamps 应 该 只 包含 stam 实例 ， 并 给 予 

CRUE , 假设 整个 代码 是 利用 Java 15 SCZ a BR BER 对 右 进 行 编译 

的 ， 所 有 代码 在 编译 过 程 中 都 没有 发 出 〈 或 者 禁止 ， Hager! 任 

aa 当 stamps 利用 一 个 参数 化 的 类 型 进 并行 声明 时 错误 的 插入 会 
条 编译 时 的 错误 消息 ， 准 确 地 告诉 你 哪里 出 错 了 : 


Test.java: 9 : add(Stamp) in Collection<Stamp> cannot be applied 
to (Coin) 


stamps. add (new Coin() ) 


还 有 一 个 好 处 是 ， 从 集合 中 删除 元 素 时 不 再 需要 进行 手工 转换 了 。 编 
译 器 会 着 你 插入 隐 式 的 转换 ， 并 确保 它们 不 会 失败 (依然 假设 所 有 代 
ee a 并 且 没 有 产生 或 者 禁止 任 
论 你 是 否 使 用 for-each 循环 〈 见 第 46 条 ) ， 上 述 功 能 都 
JH : 


for (Stamp s : stamps) { // No cast 


// Do something with the stamp 


或 者 无 论 是 否 使 用 传统 的 for 循环 也 一 样 : 
// for loop with parameterized iterator declaration - typesafe 
for (Iterator<Stamp> i = stamps.iterator(); i.hasNext(); ) { 


Stamp s = i.next(); // No cast necesary 


. // Do something with the stamp 


虽然 假设 不 小 心 将 coin 插入 到 stamp 集合 中 可 能 显得 有 点 牵强 ， 但 这 
类 问题 确实 真实 的 。 例 如 ， 很 容易 想象 有 有 人 会 不 小 心 将 一 个 
java.util.Date 实例 放 进 一 个 原本 只 包含 java.sql.Date 实例 的 集合 


如 上 所 述 ， 如 果 不 提供 类 型 参数 ， 使 用 集合 类 型 和 其 他 泛 型 也 仍然 是 
合法 的 ， 但 是 不 应 该 这 么 做 。 WRIEAUREBAA, BAPE T i BE 
ZEMRE ANAL! ° BRAD DAE RES RE, At 
么 Java 的 设计 者 还 要 人 允许 使 用 它们 呢 ? 这 是 为 了 提供 兼容 性 。 因 为 泛 
型 出 现 的 时 候 ，Java 平 台 即 将 进入 它 的 第 二 个 10 年 ， 已 经 存在 大 量 没 
有 使 用 方形 的 Java 代 码 。 人 们 认为 让 所 有 的 代码 保持 合法 ， 并 且 能 够 
与 使 用 泛 型 的 新 代码 互 用 ， 这 一 点 很 重要 。 它 必须 合法 ， 才 能 将 参数 
化 类 型 的 实例 传递 给 那些 被 设计 成 使 用 普通 类 型 的 方法 ， 反 之 亦 然 。 
这 种 需求 被 称 作 FZETEGEASTE (Migration Compatibility) ， 促 成 了 支持 
原生 态 类 型 的 决定 。 


虽然 不 应 该 在 新 代码 中 使 用 像 ust 这 样 的 原生 态 类 型 ， 使 用 参数 化 
的 类 型 以 允许 插入 任意 对 象 ， 如 List<ovject> ， 这 还 是 可 以 的 。 原 生 
SRH List 和 和 参数 化 的 类 型 List<Object> 之 间 到 底 有 什么 区 别 呢 ? 
不 严格 地 说 ， 前 者 逃避 了 泛 型 检查 ， 后 者 则 明确 告知 编译 器 ， 它 能 够 
持 有 任意 类 型 的 对 象 所 虽然 你 可 以 将 List<String> 传递 给 List 的 参 
数 ， 但 是 不 能 讲 它 传 给 类 型 List<object> 的 参数 。 泛 型 有 子 类 型 化 
(subtyping) 的 规则 ， List<string> 是 原生 态 类 型 List 的 一 个 子 类 
型 ， 而 不 是 参数 化 类 型 List<Object> 的 子 类 型 ( 见 第 25 条 ) o 因此 ， 
UREHR List PEHVRERBRE, BRAPRARZEH, (ew 
REH List<Object> ITED ERMA, 如 不 会 o 


为 了 更 具体 地 进行 说 明 ， 请 参考 下 面 的 程序 : 


// Uses raw type (List) - fails at runtime! 


public static void main (String[] args) { 


List<String> strings = new ArrayList<String>(); 


unsafeAdd(strings, new Integer( 42 )); 


String s = strings.get( 0 ); // Compiler-generated cast 


private static void unsafeAdd (List list, Object o) { 


list.add(o); 


个 程序 可 以 进行 编译 ， 但 是 因为 它 使 用 了 原生 态 类 型 is ， 你 会 


—2& Æ, 
收 到 一 条 警告 
Test.java: 10 : warning: unchecked call to add (E) in raw type list 


list. add (0) ; 


实际 上 上， 如果 运行 这 段 程序 ， 在 程序 试图 将 strings. getto) ES Yad 2 BA 
转换 成 一 个 String 时 , 会 收 到 一 个 ClassCastException 异常 。 这 是 一 个 
编译 器 生成 的 转换 ， 因 此 一 般 保证 会 成 功 ， 但 是 我 们 在 这 个 例子 中 忽 
略 了 一 条 编译 需 警 告 ， 束 会 为 此 而 付出 代价 。 


如 果 在 unsafeAdd 声明 中 使 用 参数 化 类 型 List<Object> 代替 原生 态 类 型 
List 并 试 着 重新 编译 这 段 程序 ， 会 发 现 它 无 法 再 进行 编译 了 。 以 下 
是 它 的 错误 消息 : 


Test.java: 5 : unsafeAdd(List<Object>,Object) cannot be applied 


to (List<String>, Integer ) 


unsafeAdd (strings, new Integer(42) ) ; 


在 不 确定 或 者 不 在 平 集合 中 的 元 素 类 型 的 情况 下 ， 你 也 许 会 使 用 原生 
仿 类 型 。 例 如 ， 假 设想 要 编写 一 个 方法 ， 它 有 两 个 集合 〈 se ) ， 并 
从 中 返回 它们 共有 的 元 素 的 数量 。 如 果 你 对 泛 型 还 不 熟悉 的 话 ， 可 以 
参考 一 下 方式 来 编写 这 种 方法 : 


// Use of raw type for unknown element type - don't do this! 
static int numElementsInCommon (Set s1, Set s2) { 
int result = 0; 
for (Object o1 : s1) 
if (s2.contains(o1)) 
result++; 


return result; 


这 个 方法 倒是 可 以 ， 但 它 使 用 了 原生 态 类 型 ， 这 是 很 危险 的 。 从 Java 
1.5 人 发 行 厂 本 开始 ， Java 就 提供 了 一 种 安全 的 替代 方法 ， 称 作 无 硬盘 的 

AIF (unbounded wildcard type) 。 如 果 要 使 用 泛 型 ， 但 不 确定 
或 者 不 关心 实际 的 类 型 参数 ， 束 可 以 使 用 一 个 问号 代替 。 例 如 ， 泛 型 
set<E> 的 无 限制 通配符 类 型 为 sec ”( 读 作 “ 某 个 类 型 的 集合 ”) o 
这 是 最 普通 的 参数 化 se 类 型 ， 可 以 持 有 ER RBA Fie 
numElementsInCommon 方法 使 用 了 无 限制 通 前 配 符 类 型 时 的 A 


// Unbounded wildcard type - typesafe and flexible 


static int numElementsInCommon (Set<?> s1, Set<?> s2) { 
int result = 0; 
for (Object o1 : s1) 
if (s2.contains(o1)) 
result++; 


return result; 


在 无 限制 通配符 类 型 set<?>> 和 原生 态 类 型 set 之 间 有 什么 区 别 呢 ? 
这 个 问号 真正 起 到 作用 了 吗 ? 这 一 点 不 需要 资 述 ， 但 通配符 类 型 是 安 
全 的 ， 原 生态 类 型 则 不 安全 。 由 于 可 以 将 任何 元 素 放 进 使 用 原生 态 类 
型 的 集合 中 ， 因 此 很 容易 破坏 该 集合 的 类 型 约束 条 件 (如 第 100 页 的 例 
子 中 所 示 的 unsafeAdd Te) ; (B AN BERIEHICA (RT null Z 
Sk) WEN Collection< ?> 中 。 如 果 党 试 这 么 做 的 话 ， 将 会 产生 一 条 像 
这 样 的 编译 时 错误 消息 : 


WildCard.java: 13 : cannot find symbol 
symbol : method add (String) 
location: interface Collection<capture#825 of ?> 


c. add ( "verboten" ) ; 


A 


这 样 的 错误 消息 显然 还 无 法 令 人 满意 ， 但 是 编译 名 已 经 尽 到 了 它 的 职 
页， 防止 你 破坏 集合 的 类 型 约束 条 件 。 你 不 仅 无 法 将 任何 元 杂 (除了 
null 之 外 ) 放 进 Collection<?> 中 ， 而 且 根 本 无 法 猜测 你 会 得 到 哪 种 类 


型 的 对 象 。 要 是 无 法 接受 这 些 限 制 ， 就 可 以 使 用 22 ZT (generic 
method， 见 第 27 条 ) 或 者 RHIA (bounded wildcard 
type， 见 第 28 条 ) ° 


不 要 在 新 代码 中 使 用 原生 态 类 型 ， 这 条 规则 有 两 个 小 小 的 例外 ， 两 者 
都 源 于 “ 泛 型 信息 可 以 在 运行 时 被 擦 除 ”( 见 第 25 条 ) 这 一 事实 。 在 类 
XF (class literal) 中 必须 使 用 原生 态 类 型 。 规 范 不 允许 使 用 参数 化 
类 型 (虽然 允许 数组 类 型 和 基本 类 型 [JLS，15.8.2]。 换 句 话 说 ， 
List.class , String[].class 和 int.class 都 合法 ， 但 是 
List<String.class> 和 List<?>.class 则 不 合法 Š 


这 条 规则 的 第 二 个 例外 与 instanceof 操作 符 有 关 。 由 于 泛 型 信息 可 以 
在 运行 时 被 探 除 ， 因 此 在 参数 化 类 型 而 非 无 限制 通配符 类 型 上 使 用 
instanceof 操作 符 是 非法 的 。 用 无 限制 通配符 类 型 代 蔡 原生 态 类 型 ， 
对 instanceof 操作 符 的 行为 不 会 产生 任何 影响 。 在 这 种 情况 下 ， 尖 括 
号 ( <> ) 和 间 号 ( 。 ) 就 显得 多 余 了 。 TEENA EREA 
instanceof PRIETF I AIEEE : 


// Legitimate use of raw type - instanceof operator 
if (o instanceof Set) { // Raw type 
Set<?> m = (Set<?>) 0; // Wildcard type 


注意 ， 一 旦 确定 这 个 o 是 个 set , 束 必 须 将 它 转 换 成 通配符 类 型 
set<?> ， 而 不 是 转换 成 原生 态 类 型 set 。 这 是 个 受 检 的 (checked) 
转换 ， 因 此 不 会 导致 编译 时 警告 。 


总 之 ， 使 用 原生 仿 类 型 会 在 运行 时 导致 异常 ， 因 此 不 要 在 新 代码 中 使 
用 。 原 生态 类 型 只 是 为 了 与 引入 泛 型 之 前 的 遗留 代码 进行 兼容 和 互 用 
而 提供 的 。 让 我 们 做 个 快速 的 回顾 ， set<opject> 是 个 参数 化 类 型 ， 表 
示 可 以 包含 任何 对 象 类 型 的 一 个 集合 ; set 则 是 一 个 通配符 类 型 ， 


表示 只 能 包含 某 种 未 知 对 象 类 型 的 一 个 集合 set 则 是 个 原生 态 类 
型 ， 它 脱离 了 泛 型 系统 。 前 两 种 是 安全 的 ， 最 后 一 种 不 安全 。 


为 便于 参考 ， 表 5-1 概括 了 本 条 目 中 所 介绍 的 术语 (RABE H 


中 介绍 的 一 些 术语 ) : 


表 5-1 本 章 条 目 中 所 介绍 的 术语 


术语 示例 所 在 条 目 
参数 化 的 类 型 List<String> 第 23 条 
实际 类 型 参数 String 第 23 条 
iz AY List<E> B23, 26% 
形式 类 型 参数 E 第 23 条 

通 HT 类 ee List<?> 第 未 
无 限制 通配符 类 型 第 23 条 
JAN JU ze ES List 第 FAN 
原生 态 类 型 第 23 条 

类 型 参 类 <E extends Number> 第 FR 
有 限制 类 型 参数 第 26 条 
递归 类 型 参数 <T extends Comparable<T>> 第 27 条 

J% 付 类 Ae List<? extends Number> 第 aR 
有 限制 通配符 类 型 第 28 条 
泛 型 方法 static <E> List<E> asList(E[] a) BITS 
RA SHE String.class 第 29 条 


第 24 条 : (ARP eS 


用 泛 型 编程 时 ， 会 遇 到 许多 编译 右 警 告 ， 非 受 检 强制 转化 警告 
(unchecked cast warnings) 、 非 受 检 方法 调用 敬告 、 非 受 检 普 通 数 组 
创建 警告 ， 以 及 非 受 检 和 转换 警告 (unchecked conversion warnings) ° 
当 你 越 来 越 熟 悉 沁 型 之 后 ， 遇 到 的 警告 也 会 越 来 越 少 ， 但 是 不 要 期 行 
从 一 开始 用 泛 型 编写 代码 就 可 以 正确 地 进行 编译 。 


和 
HA: 


Set<Lark> exaltation = new HashSet(); 


aE ae ZA SH pee VRE E h ts T : 
Venery.java: 4 : warning: [unchecked] unchecked conversion 
found : HashSet, required: Set<Lark> 
Set<Lark> exaltation = new HashSet(); 


A 


Ora] LAA ERER, (ARR: 


Set<Lark> exaltation = new HashSet<Lark>(); 


有 些 警告 比较 难以 消除 。 本 章 主 要 介绍 这 种 警告 的 示例 。 当 你 遇 到 需 
要 进行 一 番 思 考 的 警告 时 ， 要 坚持 住 ! FR AAEM RE IESE 
殊 千 。 如 果 消 除了 所 有 警告 ， 就 可 以 确保 代码 是 类 型 安全 的 ， 这 是 一 
件 很 好 的 事情 。 这 意味 着 不 会 在 运行 时 出 现 orasscastexception 异常 
你 会 更 加 自信 自己 的 程序 可 以 实现 预期 的 功能 。 


MURATA RE [UAT AT UE EB E KIER EZEK, 
RA ISA BO) 可 以 局 一 个 esuppresswarnings("unchecked") 注解 
殉 凡 这 条 警 千 。 如 采 在 花 止 警告 之 前 没有 移 证 实 代码 是 类 型 安全 

的 ， 那 就 只 是 给 你 目 己 一 种 错误 的 安全 感 而 已 。 代 码 在 编译 的 时 候 可 

能 没有 出 现任 何 警告 ， 但 它 在 运行 时 仍然 会 抛 出 classcastexception FF 

常 了 但 是 如 果 和 忽略 (而 不 是 禁止 ) 明知 道 是 安全 的 非 受 检 和 警告 ， 那 么 

当 新 出 现 一 条 真正 有 问题 的 警告 时 ， 你 也 不 会 注意 到 。 痢 出 现 的 警告 

就 会 济 没 在 所 有 的 错误 警告 当中 。 


suppresswarnings 注解 可 以 用 在 任何 粒度 的 级 别 中 ， 从 单独 的 局 部 变量 
声明 到 整个 类 都 可 以 。 MIRRE I BENENE A FEH 
SuppressWarnings TERE ° 它 通常 是 个 变量 声明 ， 或 是 非常 简短 的 方法 或 


者 构造 磊 。 永 远 不 要 再 整个 类 上 使 用 suppresswarnings 注解 ， 这 么 做 可 
能 会 掩 荔 了 重要 的 警告 。 


如 果 你 发 现 目 己 在 长 度 不 止 一 行 的 方法 或 者 构造 作 中 使 用 
suppresswarnings 注解， 可 以 将 它 移 到 一 个 局 部 变量 的 声明 中 。 虽 然 你 
必须 声明 一 个 新 的 局 部 变量 ， 不 过 这 么 做 还 是 值得 的 。 例 如 ， 考 虑 
ArrayList 类 当 中 的 toArray 方法 : 


public <T> toArray(T[] a) { 
if (a.length < size) 
return (T[]) Arrays.copyOf(elements, size, a.getClass()); 
System.arrayCopy(elements, ©, a, 0 , size); 
if (a.length > size) 
a[size] = null ; 


return a; 


又 . > ERLA PE yo be HE 
如 果 编 译 Arraytist , ADEMAR EARE: 
ArrayList.java: 305 : warning: [unchecked] unchecked cast 
found : Object[], required: T[] 


return (T[]) Arrays.copyOf(elements, size, a.getClass()); 


将 SuppressWarnings 注解 放 在 return 语句 中 是 非法 的 ， 因为 它 不 是 一 
个 生命 JLS，9.7]。 你 可 以 试 着 将 注解 放 在 整个 方法 上 ， 但 是 在 实践 中 


于 万 不 要 这 么 做 ， 而 是 应 该 声明 一 个 局 部 变量 来 保存 返回 值 ， 并 注解 
其 声明 ， 像 这 样 : 


// Adding local variable to reduce scope of @SuppressWarnings 
public <T> T[] toArray(T[] a) { 
if (a.length < size) { 
// This cast is correct because the array we're creating 
// is of the same type as the one passed in, which is T[]. 
@SuppressWarnings ( "unchecked" ) T[] result = 
(T[]) Arrays.copyOf(elements, size, a.getClass()); 


return result; 


System.arrayCopy(elements, ©, a, 0 , size); 
if (a.length > size) 
a[size] = null ; 


return a; 


Ww 
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FEA EH suppresswarnings(“unchecked") Egit, #8 Z%R0I—AVERE, HST LITE EZEK 


o 这样 可 以 帮助 其 他 人 理解 代码 ， 更 重要 的 是 ， 可 以 尽量 减少 其 他 人 


修改 代码 后 导致 计算 不 安全 的 概率 。 如 采 你 觉得 这 种 注释 很 难 编写 ， 
束 要 多 加 思考 。 最 终 你 会 发 现 非 受 检 操 作 时 非常 不 安全 的 。 


总 而 言 之 ， 非 受 检 和 警告 很 重要 ， 不 要 忽略 它 们 。 每 一 条 警告 都 表示 可 
能 在 运行 时 抛 出 ClassCastException FE S 要 尽 最 大 的 努力 消除 这 些 警 
告 。 如 有 果 无 法 消除 非 受 检 和 警告 ， 同 时 可 以 证 明 引 起 警告 的 代码 是 类 型 
TE, 就 可 以 在 尽 可 能 小 的 范围 中 ， 用 @SuppressWarnings ("unchecked") 
法 解禁 止 该 警告 。 要 用 注释 把 禁止 该 警告 的 原因 记录 下 来 。 


数组 与 泛 型 相 比 ， 有 两 个 重要 的 不 同 点 。 首 先 ， 数 组 是 ME 
(covariant) 。 这 个 词 听 起 来 有 点 吓人 ， 其 实 只 是 表示 如 果 sw 为 
super 的 子 类 型 ， 那 么 数组 类 型 swn 就 是 superg 的 子 类 型 。 相 
反 ， 泛 型 则 是 DAZK (invariant) : 对 于 任意 两 个 不 同 的 类 型 
Type1 和 Type2 , List<Type1> 既 不 是 List<Type2> 的 子 类 型 ， 也 不 是 
List<rype2> 的 超 类 型 [JLS，4.10; Naftalin07，2.5]。 你 可 能 认为 ， 这 
意味 着 泛 型 是 有 缺陷 的 ， 但 实际 上 可 以 说 数组 才 是 有 缺陷 的 。 


下 面 的 代码 片段 是 合法 的 : 


// Fails at runtime! 
Object[] objectArray = new Long[ 1 ]; 


objectArray[ © ] = "I don't fit in" ; // Throws ArrayStoreException 


但 下 面 这 段 代 码 则 不 合法 ; 
// Won't compile! 
List<Object> ol = new ArrayList<Object>(); // Incompatible types 


ol.add( "I don't fit in" ); 


这 其 中 无 论 哪 种 方法 ， 都 不 能 将 string 放 进 tong 容器 中 ， 但 是 利用 
数组 ， 你 会 在 运行 时 发 现 所 犯 的 错误 ;利用 列表 ， 则 可 以 在 编译 时 发 
现 错误 。 我 们 当然 希望 在 编译 时 发 现 错误 了 。 


数组 与 泛 型 之 间 的 第 二 大 区 别 在 于 ， 数 组 是 AKAI (reified) 
[JLS，4.7]。 因 此 数组 会 在 运行 时 才 知 道 并 检查 它们 的 元 素 类 型 约束 。 
如 上 所 述 ， 如 果 企 图 将 string 保存 到 tong 数组 中 ， 就 会 得 到 一 个 
ArraystoreException 异常 。 相 比 之 下 ， 泛 型 则 是 通过 AK (erasure) 
ULS，4.6] 来 实现 的 。 因 此 泛 型 只 在 编译 时 强化 它们 的 类 型 信息 ， 并 在 
运行 时 丢弃 (或 者 BR) 它们 的 元 素 类 型 信息 。 撕 除 就 是 使 泛 型 可 以 
与 没有 使 用 泛 型 的 代码 随意 进行 互 用 〈 见 第 23 条 ) 。 


由 于 上 述 这 些 根本 的 区 别 ， 因 此 数组 和 泛 型 不 能 很 好 地 混合 使 用 。 例 
如 ， 创 建 泛 型 、 参 数 化 类 型 或 者 类 型 参数 的 数组 是 非法 的 。 这 些 数 组 
创建 表达 式 没 有 个 是 合法 的 : new List<E>[] ` new List<String>[] 和 
new E[] 。 这 些 在 编译 是 都 会 导致 一 个 generic array creation 〈 泛 型 数 
组 创建 ) R o 


为 什么 创建 泛 型 数组 是 非法 的 ? 因为 它 不 是 类 型 安全 的 。 要 是 它 合 
法 ， 编 译 器 在 其 他 正确 的 程序 中 发 生 的 转换 就 会 在 运行 时 失败 ， 并 出 
现 一 个 ClassCastException Fey = AEA T ze Aa te HEME AR 
证 。 


为 了 更 具体 地 对 此 进行 讽 明 ， 考 虑 以 下 代码 所 段 : 


// Why generic array creation is illegal - won't compile 
List<String>[] stringLists = new ArrayList<String>[ 1]; // (1) 
List<Integer> intList = Arrays.asList( 42 ); // (2) 
Object[] objects = stringLists; // (3) 
objects[ 0 ] = intList; // (A) 


String s = stringLists[ © ].get( 0 ); // (5) 


我 们 假设 第 1 行 是 合法 的 ， 它 创建 了 一 个 泛 型 数组 。 第 2 行 创 建 并 初始 
化 了 一 个 包含 单个 元 素 的 List<Integer> Q 第 3 行将 List<String> 数组 保 
存 到 一 个 opject 数组 变量 中 ， 这 是 合法 的 ， 因 为 数组 是 协 变 的 。 第 4 
行将 List<Integer> 保存 到 Object 数组 里 唯一 的 元 素 中 ， 这 是 可 以 的; 
因为 沁 型 是 通过 探 除 实现 的 : ”List<Integer> 实例 的 运行 时 类 型 只 是 
List , ”List<string>[] 实例 的 运行 时 类 型 则 是 Listr] ， 因 此 这 种 安排 
不 会 产生 ArraystoreException 异常 。 但 现在 我 们 有 麻烦 了 。 我 们 将 一 个 
List<integer> 实例 保存 到 了 原本 声明 只 包含 List<string> 实例 的 数组 
中 。 在 第 5 行 中 ， 我 们 从 这 个 数组 里 唯一 的 列表 中 获取 了 唯一 的 元 素 。 
编译 器 目 动 地 将 获取 到 的 元 素 转 换 成 string ， 但 它 是 一 个 integer , 
因此 ， 我 们 在 运行 时 得 到 了 一 个 ClassCastExcption 异常 。 为 了 防止 出 现 
这 种 情况 ， (创建 泛 型 数组 的 ) 第 1 行 产 生 了 一 个 编译 时 错误 。 


从 技术 的 角度 来 说 ， 想 e 、 iste 和 List<string> 这 样 的 类 型 应 称 
YE ROACH (nonreifiable) XÆIJLS, 4.7] ° BW hin, ABTA 
体 化 的 (non-reifiable) 类 型 是 指 其 运行 时 表示 法 包含 的 信息 比 它 的 编 
译 时 表示 法 包含 的 信息 更 少 的 类 型 。 唯 一 可 具体 化 的 (reifiable) 参数 
化 类 型 是 无 限制 的 通配符 类 型 ， 如 List<?> 和 map<?,?> ( 见 第 23 
F) 。 虽 然 不 常用 ， 但 是 创建 无 限制 通配符 类 型 的 数组 是 合法 的 。 


禁止 创建 泛 型 数组 可 能 有 点 讨厌。 例如 ， 这 表明 泛 型 一 般 不 可 能 返回 
它 的 元 素 类 型 数组 (部 分 解决 方案 请 见 第 29 条 ) 。 这 也 意味 着 在 结合 
使 用 可 变 参数 (varargs) 方法 ( 见 第 42 条 ) 和 泛 型 时 会 出 现 令 人 费解 
的 警告 。 这 是 由 于 每 当 调用 可 变 参数 方法 时 ， 束 会 创建 一 个 数组 来 存 
放 varargs 参数 。 如 果 这 个 数组 的 元 素 类 型 时 不 是 可 具体 化 的 

(reifiable) ， 就 会 得 到 一 条 警告 。 关 于 这 些 警告 ， 除 了 把 它们 禁止 
， 并 有 旦 避免 在 API 中 混合 使 用 泛 型 与 可 变 参 数 之 外 ， 别 

7 o 
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类 型 Lists ， 而 不 是 数组 类 型 e 。 这 样 可 能 会 损失 一 些 性 能 或 者 
简洁 性 ， 但 十 换 回 的 却 是 更 高 的 类 型 安全 性 和 互 用 性 。 


例如 ， 假设 有 一 个 ( Collections.synchronizedList 返回 的 那 种 ) 同步 列表 
和 一 个 函数 〈 它 有 两 个 域 该 列表 的 元 素 同 类 型 的 参数 值 ， 并 返回 第 三 
AB) 。 现 在 假设 要 编写 一 个 方法 reduce , 并 使 用 函数 apply 来 处 

理 这 个 列表 。 假 设 列 表 元 素 类 型 为 整数 ， 并 且 函 数 古 用 来 做 两 个 整数 
求 和 运算 ， reduce 方法 束 会 返回 列表 中 所 有 值 的 总 和 。 如 果 函 数 古 用 


来 做 两 个 整数 求 积 的 运算 ， 该 方法 就 会 返回 列表 中 值 的 乘积 。 如 果 列 
表 包 合 字 符 果 ， 并 且 函 数 和 连接 两 个 字符 串 ， 该 方法 就 会 返回 一 个 字符 
串 ， 它 按 顺 序 包 含 了 列表 中 的 所 有 字符 串 。 除 了 列表 和 函数 之 外 ， 
reduce 方法 还 采用 初始 值 进行 减法 运算 ， 列表 为 空 时 会 返回 这 个 初始 
值 。 (初始 值 一 般 为 画 数 的 识别 元 素 ， 加 法 为 0， 乘 法 为 1， 字 符 串 连 
接 时 是 。) 以 下 是 没有 泛 型 时 的 代码 ? 


// Reduction without generics, and wit 


n concurrency flaw! 


static Object reduce (List list, Function f, Object initVal) { 


synchronized (list) { 


Object result = initVal; 


for (Object o : list) 


result = f.apply(result, o); 


return result; 


interface Function { 


Object apply (Object argi, Object arg2) ; 


假设 你 现在 已 经 读 过 第 67 条 ， 它 告诉 你 不 要 从 同步 区 域 中 调用 “外 来 的 
(alien) 方法 *”。 因 此， 在 持 有 锁 的 时 候 修改 reduce 方法 来 复制 列表 


中 内 容 ， 也 可 以 让 你 在 备份 上 执行 减法 。Java 1.5 发 行 版 本 之 前 ， 要 这 
么 做 一 般 是 利用 List 的 toArray 方法 ( 它 在 内 部 锁定 列表 ，) : 


// Reduction without generics or concurrency flaw 
static Object reduce (List list, Function f, Object initVal) { 
Object[] snapshot = list.toArray(); // Locks list internally 
Object result = initVal; 
for (E e : snapshot) 
result = f.apply(result, e); 


return result; 


MARENE Iz OR SE BGR RA, MARR RA BEARER i 
Ki 2 以 下 是 Function 接口 的 泛 型 版 : 


interface Function < T> { 


T apply (T argi, T arg2) ; 


下 面 是 一 种 天 真 的 演 试 ， 试 图 将 泛 型 应 用 到 修改 过 的 reduce 方法 。 这 
是 一 个 ZEE (generic method， 见 第 27 条 ) 。 如 果 你 不 理解 这 条 
ie 也 不 必 担 心 。 对 于 这 个 条 目 来 说 ， 应 该 把 注意 力 集 中 在 方法 体 


// Naive generic version of reduction - won't compile! 


static <E> E reduce (List<E> list, Function<E> f, E initVal) { 


E[] snapshot = list.toArray(); // Locks list 


E result = initVal; 


for (E e : snapshot) 


result = f.apply(result, e); 


return result; 


如 果 试 着 编译 这 个 方法 ， 就 会 得 到 下 面 的 错误 消息 : 
Reduce.java: 12 : incompativle types 
found : Object[], required: E[] 


E[] snapshot = list.toArray(); // Locks list 


~ 这 没什么 大 不 了 的 ， 我 会 将 opject 数组 转换 成 一 个 上 数 


E[] snapshot = (E[]) list.toArray(); 


站 > ELA th > E 4A a ha 
已 是 消除 了 那 条 错误 ， 但 是 现在 得 到 了 一 条 警告 : 
Reduce.java: 12 : warning: [unchecked] unchecked cast 

found : Object[], required:L E[] 


E[] snapshot = (E[]) list.toArray(); // Locks list 


编译 器 告诉 你 ， 它 无 法 在 运行 时 检查 转换 的 安全 性 ， 因 为 它 在 运行 时 
还 不 知道 e 是 什么 一 一 记 住 ， 元 素 类 型 信息 会 在 运行 时 从 泛 型 中 被 
探 除 。 这 上段 程序 可 以 运行 吗 ? 结果 表明 ， 它 可 以 运行 ， 但 是 不 安全 。 
通过 微小 的 修改 ， 束 可 以 让 它 在 没有 包含 显 式 转换 的 行 上 抛 出 
ClassCastException 异常 。 snapshot 的 编译 时 类 型 为 EHI, 它 可 以 为 
string[] ` Integer[] 或 者 任何 其 他 种 类 的 数组 。 运 行 时 类 型 为 
object] ， 这 是 很 危险 的 。 不 可 有 具体 化 的 类 型 的 数组 转换 只 能 在 特殊 
情况 下 使 用 ( 见 第 26 条 ) ° 

那么 应 该 做 些 什么 呢 ? 用 列表 代替 数组 。 下 面 的 reae 方法 编译 时 就 


没有 任何 错误 或 者 警告 : 


// List-based generic reduction 


static ESE reduce (List<E> list, Funciton<E> f, E initVal) 
List<E> snapshot; 


synchronized (list) { 


snapshot = new ArrayList<E>(list); 


E result = initVal; 
for (E e : snapshot) 
result = f.apply(result, e); 


return result; 


这 个 版 本 的 代码 比 数组 版 的 代码 稍微 见长 一 点 ， 但 是 可 以 确定 在 运行 
时 不 会 得 到 ClassCastException ae 为 此 也 值 了 ° 


总 而 言 之 ， 数 组 和 泛 型 有 着 非常 不 同 的 类 型 规则 。 数 组 钙 协 变 并 且 可 
以 具体 化 的 ， 反 省 是 不 可 变 的 且 可 以 被 控 除 的 。 因 此 ， 数 组 提供 了 运 
行 时 的 类 型 安全 ， 但 是 没有 编译 时 的 类 型 安全 ， 反 之 ， 对 于 泛 型 也 一 
样 。 一 般 来 说 ， 数 组 和 泛 型 不 能 很 好 地 混合 使 用 。 如 果 你 发 现 目 己 将 
它们 混合 起 来 使 用 ， 并 且 得 到 了 编译 时 的 错误 或 者 警告 ， 你 的 第 一 反 
应 丈 应 该 是 用 列表 代替 数组 。 


第 26 条 : 优先 考虑 泛 型 


一 般 来 说 ， 将 集合 声明 参数 化 ， 以 及 使 用 JDK 所 提供 的 泛 型 和 泛 型 方 
法 ， 这 些 都 不 太 困难 。 编 写 自己 的 泛 型 会 比较 困难 一 些 ， 但 是 值得 花 
些 时 间 学 习 如 何 编写 。 


考虑 第 6 条 中 这 个 简单 的 堆栈 实现 : 


// 0bject-based collection a prime candidate for generics 


public class Stack { 


private Object[] elements; 


private int size = 0; 


private static final int DEFAULT_INITIAL_CAPACITY = 16 ; 


public Stack () { 


elements = new Object[DEFAULT_INITIAL_CAPACITY]; 


public void push (Object e) { 


ensureCapacity(); 


elements[size++] = e; 


public Object pop () { 


if (size == 0 ) 


throw new EmptyStackException(); 


Object result = elements[--size]; 


elements[size] = null ; // Eliminate obsolete reference 


return result; 


public boolean isEmpty () { 


return size == 0; 


private void ensureCapacity () { 


if (elements.length == size) 


elements = Arrays.copyOf(elements, 2 * size + 1 ); 


这 个 类 是 ZÆ (generification) 的 主要 备 选 对 象 ， 换 句 话 说， 可 以 

适当 地 强化 这 个 类 类 利用 泛 型 。 根 据 实 际 情况 来 看 ， 必 须 转 换 从 堆栈 

里 弹出 的 对 象 ， 以 及 可 能 在 运行 时 失败 的 那些 转换 。 将 类 泛 型 化 的 第 

一 个 步骤 是 给 它 的 声明 添加 一 个 或 者 多 个 类 型 参数 。 在 这 个 例子 中 有 

一 个 类 型 参数 ， 它 表示 堆栈 的 元 素 类 型 ， 这 个 参数 的 名 称 通常 为 E 
( 见 第 44 条 ) 。 


下 一 步 是 用 相应 的 类 型 参数 替换 所 有 的 _ ovjeee 类 型 
终 的 程序 


// Initial attempt to generify Stack = won't compile 


然后 试 着 编译 最 


public class Stack <E> { 
private E[] elements; 
private int size= 0; 


private static final int DEFAULT_INITIAL_CAPACITY = 16 ; 


public Stack () { 


elements = new E[DEFAULT_INITIAL_CAPACITY]; 


public void push (E e) { 


ensureCapacity(); 


elements[sizet++] e; 


public E pop () { 


if (size == 0 ) 


throw new EmptyStackException(); 


E result = elements[--size]; 


elements[size] = null ; // Eliminate obsolete reference 


return result; 


// no changes in isEmpty or ensureCapacity 


A, IRD SE -ARARE TRADI e ANE, 
这 个 类 只 产生 一 个 错误 ， 如 下 : 


Stack.java: 8 : generic array creation 
elements = new E[DEFAULT_INITIAL_CAPACITY]; 


A 


如 第 25 条 中 所 述 ， 你 不 能 创建 不 可 具体 化 的 (non-reifiable) 类 型 的 

BA, We 。 每 当 编写 用 数组 文 持 的 泛 型 时 ， 都 会 出 现 这 个 问题 。 

解决 这 个 问题 有 两 种 方法 。 第 一 种 ， 直 接 绕 过 创建 沁 型 数组 的 禁令 : 

创建 一 个 oject 的 数组 ， 并 将 它 转换 为 泛 型 数组 类 型 。 现 在 错误 中 消 
除了 ， 但 是 编译 器 会 产生 一 条 和 警告。 这 种 用 法 是 合法 的 ， 但 (整体 上 
ME) 不 是 类 型 安全 的 : 


Stack.java: 8 : [unchecked] unchecked cast 


found : Object[], required: E[] 


elements = (E[]) new Object[DEFAULT_INITIAL_CAPACITY]; 


A 


编译 器 不 可 能 证 明 你 的 程序 是 类 型 安全 的 ， 但 是 你 可 以 证 明 。 你 自己 

必须 确保 未 受 检 的 转换 不 会 危及 到 程序 的 类 型 安全 性 。 相 关 的 数组 
( 即 slenents 变量 ) 保存 在 一 个 私有 的 域 中 ， 永 远 不 会 被 返回 到 客户 

端 ， 或 者 传递 给 任何 其 他 方法 。 这 个 数组 中 保存 的 唯一 元 素 ， 是 传 给 

po 方法 的 那些 元 素 ， 它 们 的 关 型 为 。 ， 因 此 未 受 检 的 转换 不 会 有 
可 危害 。 


一 旦 你 证 明了 未 受 检 的 转换 是 安全 的 ， 就 要 在 尽 可 能 小 的 范围 中 禁止 
警告 ( 见 第 24 条 ) 。 在 这 种 情况 下 ， 构 造 器 只 包含 未 受 检 的 数组 创 
建 ， 因 此 可 以 在 整个 构造 器 中 禁止 这 条 警告 。 通 过 增加 一 条 注解 来 完 
成 禁止 ， stack 能 够 正确 无 误 地 进行 编译 ， 你 残 可 以 使 用 它 了 ， 无 需 
显 式 的 转化 ， 也 无 需 担 心 会 出 现 ClassCastException F: 


// The elements array will contain only E instances from push(E). 


// This is sufficient to ensure type safety, but the runtime 


// type of the array won't be E[]; it will always be Object[]! 
@SuppressWarnings ( "unchecked" ) 
public Stack () { 


elements = (E[]) new Object[DEFAULT_INITIAL_CAPACITY]; 


消除 Stack 中 泛 型 数组 创建 错误 的 第 二 种 方法 是 ， 将 elements 域 的 类 
型 从 ety WH object 。 这 么 做 会 得 到 一 条 不 同 的 错误 : 


Stack.java: 19 : incompatible types 
found : Object, required: E 


E result = elements[--size]; 


通过 把 从 数组 中 获取 到 的 元 素 有 object 转换 成 E ， 可 以 将 这 条 错误 
变 成 一 条 警告 
Stack.java: 19 : warning: [unchecked] unchecked cast 


found : Object, required: E 


E result = elements[--size]; 


由 于 E 是 一 个 不 可 具体 化 的 (non-reifiable) 类 型 ， 编 译 器 无 法 在 运 
行 时 检验 转换 。 你 还 是 可 以 目 己 证 实 未 受 检 的 转换 是 安全 的 ， 因 此 可 
以 人 禁止 该 警告 。 根 据 第 24 条 的 建议 ， 我 们 只 要 在 包含 未 受 检 转 换 的 任 
务 上 禁止 警告 ， 而 不 是 在 整个 pop 方法 上 就 可 以 了 ， 如 下 : 


// Appropriate suppression of unchecked warning 
public E pop () { 
if (size == 0) 


throw new EmptyStackException(); 


// push requires elements to be of type E, so cast is correct 
@SuppressWarnings ( "unchecked" ) E result = 


(E) elements[--size]; 


elements[size] = null ; // Eliminate obsolete reference 


return result; 


具体 选择 这 两 种 方法 中 的 哪 一 种 来 处 理 泛 型 数组 创建 错误 ， 这 要 看 个 
人 的 人 篇 好 了 。 所 有 其 他 的 东西 都 一 样 ， 但 是 禁止 数组 类 型 的 未 受 检 转 
换 比 禁止 标量 类 型 (scalar type) 的 更 加 危险 ， 所 以 建议 采用 第 二 种 方 
案 。 但 是 在 比 stack 更 实际 的 泛 型 类 中 ， 或 许多 代码 会 有 多 个 地 方 需 
要 从 数组 中 读 取 元 素 ， 因 此 选择 第 二 种 方案 需要 多 次 转换 成 E ， 而 
不 是 只 转换 成 Er] ， 这 也 是 第 一 种 方案 之 所 以 更 常用 的 原因 
[Naftalin07, 6.7] ° 


下 面 的 程序 示范 了 泛 型 stack 类 的 使 用 。 程 序 以 相反 的 顺序 打印 出 它 
的 命令 行 参数 ， 并 转换 成 大 写字 母 。 如 采 要 从 堆栈 中 弹出 的 元 素 上 调 
用 String 的 toUpperCase 方法 ， 并 不 需要 显 式 的 转换 ， 并 且 会 确保 目 
动 生成 的 转换 会 成 功 : 


// Little program to exercise our generic Stack 
public static void mai (String[] args) { 
Stack<String> stack = new Stack<String>(); 
for (String arg : args) 
stack.push(args); 
while (!stack.isEmpty()) 


System.out.printin(stack.pop.toUpperCase()); 


看 来 上 述 的 示例 与 第 25 RMA IGT, B 25 REIL TC te AA Ze AF 
数组 。 实 际 上 并 不 可 能 总 是 或 者 总 想 在 泛 型 中 使 用 列表 。Java 并 不 是 
生来 就 支持 列表 ， 因 此 有 些 泛 型 如 Arraytist M) 必须 在 数组 上 实现 。 
为 了 提升 性 能 ， 其 他 泛 型 如 nasnwap 也 在 数组 上 实现 。 


绝 大 多 数 这 型 就 像 我 们 的 stack 示例 一 样 ， 因 为 它们 的 类 型 参数 没有 
限制 |: 你 可 以 创建 Stack<Object> 、  Stack<int[]> 、  Stack<List<String>> 
， 或 者 任何 其 他 对 象 引用 类 型 的 stak 。 注 意 不 能 创建 基本 类 型 的 
Stack : 企图 创建 Stack<int> 或 考 Stack<double> 会 产生 一 个 编译 时 错 
误 。 这 是 Java 沁 型 系统 根本 的 局 限 性 。 你 可 以 通过 使 用 包 帮 类 型 
(boxed primitive type) 来 避 开 这 条 限制 (ULES 49 条 ) ° 


有 一 些 泛 型 限制 了 可 人 允许 的 类 型 参数 值 。 例 如 ， 考 虑 


java.util.concurrent.DelayQueue  ， 夫 万 H 


class DelayQueue < E extends Delayed > implements BlockingQueue < E > 


类 型 参数 列表 ( <E extends velayed> ) 要 求实 际 的 类 型 参数 E 必须 是 
java.util.concurrent.Delayed 的 一 个 子 类 型 9 它 人 允许 DelayedQueue 实现 及 
其 客户 端 在 DelayedQueue 元 素 上 利用 Delayed 方法 ， 无 需 显 式 的 转换 ， 
也 没有 出 现 ClassCastException 的 风险 g 类 型 参数 E 被 称 作 APR HIRI 
RHE (bounded type parameter) 。 注 意 ， 子 类 型 关系 确定 了 ， 
个 类 型 都 是 它 目 身 的 子 类 型 [JLS,， 4.10], 因此 创建 DelayedQueue<Delayed> 
是 合法 的 。 


总 而 言 之 ， 使 用 泛 型 比 使 用 需要 在 客户 端 代码 中 进行 转换 的 类 型 来 得 
更 加 安全 ， 也 更 加 容易 。 在 设计 新 类 型 的 时 候 ， 要 确保 它们 不 需要 这 
种 转换 就 可 以 使 用 。 这 通常 意味 着 要 把 类 做 成 是 泛 型 的 。 只 要 时 间 允 
许 ， 就 把 现 有 的 类 型 都 泛 型 化 。 这 对 于 这 些 类 型 的 新 用 户 来 说 会 变 得 
更 加 qingso9ng， 又 不 会 破坏 现 有 的 客户 端 ( 见 第 23 条 ) 。 


第 27 条 : MICS IZ TTS 


就 如 类 可 以 从 沁 型 中 收益 一 般 ， 方 法 也 一 样 。 静 态 工 具 方 法 尤其 适合 
FZ ALY, © Collections 中 的 所 有 “算法 ”方法 (例如 binarySearch 和 
sort ) ERZ Æ T 2 


编写 泛 型 方法 与 编写 泛 型 类 相 类 似 。 例 如 下 面 这 个 方法 ， 它 返回 两 个 
集合 的 联合 : 


// Uses raw types - unacceptable! (Item 23) 


public static Set union (Set si, Set s2) { 


Set result = new HashSet(s1); 


result .addAll(s2); 


return result; 


这 个 方法 可 以 编译 ， 但 是 有 两 条 警告 : 
Union.java: 5 : warning: [unchecked] call to 


Hashset (Collection<? extends E>) as a member of raw type HashSet 


Set result = new HashSet(s1); 


Union.java: 6 : warning: [unchecked] call to 


addAll (Collection<? extends E>) as a member of raw type Set 


result. addAll (s2) ; 


A SAB IER ES, TTA E RMS, BTR HERA 
声明 一 个 类 型 参数 ， 表 示 这 三 个 集合 的 元 素 类 型 (两 个 参数 和 一 个 返 
ME) ， 并 在 方法 中 使 用 类 型 参数 。 声 明 类 型 参数 的 类 型 参数 列表 ， 
处 在 方法 的 修 请 从 及 其 返回 类 型 之 间 。 在 这 个 示例 中 ， 类 型 参数 列表 
为 < ， 返 回 类 型 为 sec 。 夫 型 参数 的 命名 管理 与 泥 型 方法 以 及 
泛 型 的 相同 ( 见 第 26 条 和 第 44 F) 

// Generic method 

public static <E> Set<E> union (Set<E> si, Set<E> s2) { 

Set<E> result = new HashSet<E>(s1); 


result.addAll(s2); 


return result; 


至 少 对 于 简单 的 泛 型 方法 而 言 ， 就 是 这 么 回 事 了 。 现 在 该 方法 编译 时 
不 会 产生 任何 警告 ， 并 提供 了 类 型 安全 性 ， 也 更 容易 使 用 。 以 下 是 一 
个 知性 该 方法 的 简单 程序 。 程 序 中 不 包含 转换 ， 编 译 时 不 会 有 错误 或 


者 警告 : 


// Simple program to exercise generic method 
public static void main (String[] args) { 
Set<String> guys = new  HashSet<String>( 


Arrays.asList( "Tom" , "Dick" , "Harry" )); 


Set<String> stooges = new HashSet<String>( 
Arrays.asList( "Larry" , "Moe" , "Curly" )); 
Set<String> aflCio = union(guys, stooges); 


System.out.println(af1lCio); 


运行 这 段 程序 时 ， 会 打印 出 [Moe, Harry, Tom, Curly, Larry, Dick] ° ILAA 
的 顺序 是 依赖 于 实现 的 。 


union 方法 的 局 限 性 在 于 ， 三 个 集合 的 类 型 (两 个 输入 参数 和 一 个 返 
回 值 ) 必须 全 部 相同 。 利 用 AREENA (bounded wildcard 
type) ， 可 以 使 这 个 方法 变 得 更 加 灵活 ( 见 第 28 条 ) 。 


泛 型 方法 的 一 个 显著 特性 是 ， 无 需 明确 指 定 类 型 参数 的 值 ， 不 像 调 用 
沁 型 构造 器 的 时 候 是 必须 指定 的 。 编 译 器 通过 检查 方法 参数 的 类 型 来 
计算 类 型 参数 的 值 。 对 于 上 述 的 程序 而 言 ， 编 译 器 发 现 union 的 两 个 
参数 都 是 set<string> 类 型 ， 因 此 知道 类 型 参数 E 必须 为 string 。 这 
个 过 程 称 作 类 型 你 时 (type inference) ° 


如 第 1 条 所 述 ， 可 以 利用 泛 型 方法 调用 所 提供 的 类 型 推导 ， 使 创建 参数 
化 类 型 实例 的 过 程 变 得 更 加 轻松 。 提 醒 一 下 :在 调用 泛 型 构造 紫 的 时 
候 ， 要 明确 传递 类 型 参数 的 值 可 能 有 点 厅 烦 。 类 型 参数 出 现在 了 变量 
声明 的 左右 两 边 ， 显 得 有 些 风 余 : 


// Parameterizedtype instance creation with constructor 
Map<String, List<String>> anagrams = 


new HashMap<String, List<String>>(); 


为 了 消除 这 种 见 余 ， 可 以 编写 一 个 eZ LL DA (generic static 
factory method) ， 与 想 要 使 用 的 每 个 构造 句 相 对 应 。 例 如 ， 下 面 是 一 


个 与 无 参 的 hasnwap 构造 器 相对 应 的 泛 型 静态 工厂 方法 : 
// Generic static factory method 
public static <K, V> HashMap<K, V> newHashMap () { 


return new HashMap<K, V>(); 


IIR Nz ASL) D, AT DAFA Pa Beta SS RCE TA 
那个 重复 的 声明 : 


// Parameterizedtype instance creation with static factory 


Map<String, List<String>> anagrams = newHashMap(); 


FZE EAE, GIB SATA ES Sa Biz RAY 
所 做 的 相同 ， 那 就 好 了 。 将 来 的 某 一 天 也 许可 以 实现 这 一 点 ， 但 截至 
Java 1.6 发 行 版 还 不 行 。 


KARA Ret ZEAL (generic singleton factory) 。 有 了 时， 会 需 
要 创建 不 可 变 但 又 适合 于 许多 不 同类 型 的 对 象 。 由 于 泛 型 是 通过 捧 除 
( 见 第 25 条 ) 实现 的 ， 可 以 给 所 有 必要 的 类 型 参数 使 用 单个 对 象 ， 但 
是 需要 编写 一 个 静态 工厂 方法 ， 重 复 地 给 每 个 必要 的 类 型 参数 分 发 对 
象 啊 。 这 种 模式 最 常用 于 函数 对 象 见 第 21 条 ) ， 如 
Collections.reverseOrder , 但 也 适用 于 像 Collections.emptySet 这 样 的 集 


& o 


Lee te 描述 了 一 个 方法 ， 该 方法 接受 和 返回 某 个 类 型 Y 


public interface UnaryFunction < T> { 


T apply (T arg) ; 


DUE i Se he fk PS NZX (identity function) 。 如 果 在 每 次 需要 
的 时 候 都 重 狐 创建 一 个 ， 这 样 会 很 浪费 ， 因 为 它 是 无 状态 的 
(stateless) 。 如 果 泛 型 被 具体 化 了 ， 每 个 类 型 都 需要 一 个 恒 等 函数 ， 
但 是 它 们 被 擦 除 以 后 ， 束 只 需要 一 个 泛 型 单 例 。 请 看 以 下 示例 : 


// Generic singleton factory pattern 


private static UnaryFunction<Object> IDENTITY_FUNCTION = 


new UnaryFunction<Object>() { 


public Object apply (Object arg) { return arg; } 


// IDENTITY_FUNCTION is stateless and its type parameter is 


// unbounded so it's safe to share one instance across all types. 


@SuppressWarnings ( "unchecked" ) 


public static <T> UnaryFunction<T> identityFunction () { 


return (UnaryFunction<T>) IDENTITY_FUNCTION; 


IDENTITY_FUNCTION 转换 成 ( UnaryFunction<T> ) FE 了 一 条 未 受 检 转换 警 
Fs 因为 UnaryFunction<O0bject> 对 于 每 个 T 来 说 并 非 都 是 个 

unaryFunction<t> 。 但 是 恒 等 贸 数 很 特殊 ， 它 返回 未 个 修改 的 参数 ， 
此 我 们 知道 无 论 T 的 值 是 什么 ， 用 它 作为 UnaryFunction<T> 都 是 类 型 


安全 的 。 因 此 ， 我 们 可 以 放心 地 禁止 由 这 个 转换 所 产生 的 未 受 检 转 换 
警告 。 一 旦 禁止 ， 代 码 在 编译 时 就 不 会 出 现任 何 错误 或 者 警告 。 


以 下 是 一 个 范例 程序 ， 利用 泛 型 单 例 作 为 UnaryFunction<String> 和 
unaryFunction<Number> 。 像 往常 一 样 ， 它 不 包含 转换 ， 编 译 时 没有 出 现 
错误 或 者 警告 : 
// Sample program to exercise generic singleton 
public static void main (String[] args) { 
String[] strings = { "jute" , "hemp" , "nylon" }; 
UnaryFunction<String> sameString = identityFunction(); 


for (String s : strings) 


System.out.printiln(sameString.apply(s)); 


Number[] numbers = { 1, 2.0, 3L }; 
UnaryFunction<Number> sameNumber = identityFunction(); 
for (Number n : numbers) 


System.out.println(sameNumber .apply(n)); 


虽然 相对 少见 ， 但 是 通过 某 个 包含 该 类 型 参数 本 身 的 表达 式 来 限制 类 
型 参数 是 允许 的 。 这 就 是 VFA AY SR Hi (recursive type bound ) ° 
eo comparable 接口 有 关 ， 它 定义 类 型 的 自 
PR IWF: 


public interface Comparable < T> { 


int compareTo (T 0o) ; 


类 型 参数 T 定义 的 类 型 ， 可 以 与 实现 Comparable<T> 的 类 型 的 元 素 进 
行 比较 。 实 际 上 ， 几 乎 所 有 的 类 型 都 只 能 与 它们 目 映 的 类 型 的 元 素 相 
比较 。 因此 ， 例如 String 实现 Comparable<String> , Integer 实现 
Comparable<Integer> , 等 等 2 

有 许多 方法 都 向 有 一 个 实现 Comparable 接口 的 元 素 列 表 ， 为 了 对 列表 
进行 排序 ， 并 在 其 中 进行 搜索 ， 计 算 它 的 最 小 值 或 者 最 大 值 ， 等 等 。 
要 完成 这 其 中 的 任何 一 项 工作 ， 要 求 列 表 中 的 每 个 元 素 都 能 够 与 列表 
中 的 每 个 其 他 元 素 相 比较 ， 换 名 话说， 列表 的 元 素 AMEER 
(mutually comparable) 。 下 面 是 如 何 表达 这 种 约束 条 件 的 一 个 示例 : 


// Using a recursive type bound to express mutual comparability 


public static <T extends Comparable<T>> T max (List<T> list) Ce} 
类 型 限制 <T extends Comparable<T>> 可 以 读 作 | 对 可 以 与 = 吴 进 行 比较 
的 每 个 类 型 + ”， 这 与 互 比 性 的 概念 或 多 或 少 有 些 一 致 。 


下 面 的 方法 殊 囊 有 上 述 声 明 。 它 根据 元 素 的 目 然 顺 序 计算 列表 的 最 大 
值 ， 编 译 时 没有 出 现任 何 错误 或 者 警告 : 


// Returns the maximum value in a list - uses recursive type bound 


public static <T extends Comparable<T>> T max (List<T> list) { 


Iterator<T> i = list.iterator(); 


T result = i.next(); 


while (i.hasNext()) { 


T t = i.next(); 


if (t.compareTo(result) > 0 ) 


result = t; 


} 


return result; 


递归 类 型 限制 可 能 比 这 个 要 复杂 得 多 ， 但 笠 运 的 是 ， 这 种 情况 并 不 经 
常 发 生 。 如 果 你 理解 了 这 种 习惯 用 法 及 其 通配符 变量 〈 见 第 28 条 ) ， 
束 能 够 处 理 在 实践 中 直到 的 许多 递归 类 型 限制 了 。 


总 而 言 之 ， 泛 型 方法 束 像 沁 型 一 样 ， 使 用 起 来 比 要 求 客户 端 转 换 输入 
参数 并 运 回 值 的 方法 来 得 更 加 安全 ， 也 更 加 容易 。 束 像 类 型 一 样 ， 你 
应 该 确保 新 方法 可 以 不 用 转换 束 能 使 用 ， 这 通 各 意味 着 要 将 它们 泛 型 
化 。 并 且 就 像 类 型 一 样 ， 还 应 该 将 现 有 的 方法 泛 型 化 ， 使 新 用 户 使 用 
起 来 更 加 轻松 ， 且 不 会 破坏 现 有 的 客户 端 〈 见 第 23 条 ) 。 


第 28 条 : 利用 有 限 通配符 来 提升 API 
的 灵活 性 


如 第 25 条 所 述 ， 参 数 化 类 型 是 不 也 变 的 《invariant) 。 换 句 话 说， 对 
于 任何 两 个 截然 不 同 的 type 和 type2 而 言 ， uist<rypel> BEANE 
List<Type2> 的 子 类 型 ， 也 不 是 它 的 超 类 型 。 虽 然 List<string> 不 是 
List<object> 的 子 类 型 ， 这 与 直觉 相悖 ， 但 是 实际 上 很 有 意义 。 你 可 以 
将 任何 对 象 放 进 一 个 List<opject> 中 ， 却 只 能 将 字符 串 放 进 


List<String> 


有 时 候 ， 我 们 需要 的 灵活 性 要 比 不 可 变 类 型 所 能 提供 的 更 多 。 考 虑 第 
26 条 中 的 堆栈 ， 下 面 束 是 它 的 公共 API: 


public class Stack <E > { 
public Stack () ; 
public void push (E e) ; 
public E pop () $ 


public boolean isEmpty () ; 


假设 我 们 想 要 增加 一 个 方法 ， 让 它 按 顺 序 将 一 系列 的 元 素 全 部 放 到 堆 
栈 中 。 这 是 第 一 次 尝试 ， 如 下 ， 


// pushAll method without wildcard type - deficient! 
public void pushAll (Iterable<E> src) { 
for (Ee: src) 


push(e); 


这 个 方法 编译 时 正确 无 误 ， 但 并 非 尽 如 人 意 如 果 Iterable src 的 元 
素 类 型 与 堆栈 的 完全 匹配 ， 就 没有 问题 。 但 是 假如 有 一 个 

Stack<Number> , 并 且 调 用 了 push(intVal) , 这 里 的 intval 就 是 Integer 
类 型 。 这 是 你 可 以 的 ， 因 为 integer 是 number 的 一 个 子 类 型 。 因 此 从 
逻辑 上 来 说 ， 下 面 这 个 方法 应 该 也 可 以 : 


Stack<Number> numberStack = new Stack<Number>(); 


Iterable<Integer> integers = ...; 


numberStack.pushAll(integers); 


但 是 ， 如 果 笑 试 这 么 做 ， 殊 会 得 到 下 面 的 错 座 消 恩 ， 因 为 如 前 所 述 ， 
参数 化 类 型 古 不 可 变 的 : 


StackTest.java: 7 : pushAll(Iterable<Number>) in Stack<Number> 
cannot be applied to (Iterable<Integer>) 


numberStack. pushAll (integers) ; 


幸运 的 是 ， 有 一 种 解决 办 法 。Java 提 供 了 一 种 特殊 的 参数 化 类 型 ， 称 
VE APR RATE ACTFAZ (bounded wildcard type) ， 来 处 理 类 似 的 情 
况 。 pusa 的 输入 参数 类 型 不 应 该 为 “ E 的 iterare O”, MA 
AS E 的 某 个 子 类 型 的 rterable 接口 ”， 有 一 个 通配符 类 型 正 符合 
He: Iterable<? extends E> 9 (使 用 关键 字 extends 有 些 误导 : 忆 
一 下 第 26 条 中 的 说 法 ， 确 定 了 FAA (subtype) 后 ， 每 个 类 型 便 都 
是 目 身 的 子 类 型 ， 即 便 它 没有 将 目 己 扩展 。) 我 们 修改 一 下 pusha 
来 使 用 这 个 类 型 : 


// Wildcard type for parameter that serves as an E producer 
public void pushAll (Iterable<? extends E> src) { 
for (Ee: src) 


push(e); 


这 人 么 修改 了 以 后 ， 不 仅 stack 可 以 正确 无 误 地 编译 ， 没 有 通过 初始 的 
pushAll 声明 进行 编译 的 客户 端 代 码 也 一 样 可 以 。 因 为 stack KEZ 
户 端正 确 无 旋 地 进行 了 编译 ， 你 束 知 道 一 切 都 是 类 型 安全 的 了 。 


现在 假设 想 要 编写 一 个 _pushAll 方法 ， 使 之 与 popi 方法 相 呼应 。 
popAll 方法 从 对 战 中 弹出 没 个 元 素 ， 并 将 这 些 元 素 添加 到 指定 的 集合 
Ho AIRE SAY popa 方法 可 能 像 下 面 这 样 : 


// popAll method without weildcard type - deficient! 
public void popAll (Collection<E> dst) { 
while (!isEmpty()) 


dst.add(pop()); 


如 有 果 目 标 集 合 的 元 素 类 型 与 堆栈 的 完全 匹配 ， 这 上 段 代 码 编译 时 还 是 会 
正确 无 误 ， 运 行 得 很 好 。 但 是 ， 也 并 不 意味 着 尽 如 人 意 。 假 设 你 有 一 
Ah Stack<Number> 和 类 型 Object 的 变量 2 如 果 从 堆栈 中 弹出 一 | TLE, 
并 将 它 保存 在 该 变量 中 ， 它 的 编译 和 运行 都 不 会 出 错 ， 那 你 为 何不 能 
也 这 么 做 呢 ? 


Stack<Number> numberStack = new Stack<Number>(); 
Collection<Object> objects = ...; 


numberStack.popAll(objects); 


QAR FA Evatt) ppa 版 本 编译 这 段 客户 端 代 码 ， 就 会 得 到 一 个 非 
常 类 似 于 第 一 次 用 pushAll 时 所 得 到 的 错误 : Collection<Object> 不 是 
Collection<Number> 的 子 类 型 。 这 一 次 ， 通配符 类 型 同样 提供 了 一 种 解 
决 办 法 。 popa 的 输入 参数 类 型 不 应 该 为 “< E 的 集合 "， 而 应 该 为 “ 
E 的 某 种 超 类 的 集合 ”( 这 里 的 超 类 是 确定 的 ， 因 此 E 是 它 自 身 的 
一 个 超 类 型 JILS，4.10]) 。 仍 然 有 一 个 通配符 正 是 符合 此 意 : 
Collection<? super E> g 让 我 们 修改 popAll 来 使 用 它 : 


// Wildcard type for parameter that serves as an E consumer 


public void popAll (Collection<? super E> dst) { 
while (!isEmpty()) 


dst.add(pop()); 


做 了 这 个 变动 之 后 ， stack MIZE hia CAS RAB FY CATE ATC a aE 
T° 


结论 很 明显 。 WSR RARE Ria, ZERRE A RKA 
君 的 稻 人 参数 上 使用 遂 肪 从 关 型 。 如 末 某 个 输入 参数 既是 生产 者 ， 有 
事 消 费 者 ， 那 么 通配符 类 型 对 你 区 ® 没 有 什么 好 处 了 : 因为 你 需要 的 是 
严格 的 类 型 匹配 ， 这 有 征 不 用 任何 通配符 而 得 到 的 。 


下 面 的 助 记 符 便 于 让 你 记 住 要 使 用 哪 种 通配符 类 型 : 


PECS 表示 producer-extends, consumer-super ° 


换 名 话说， 如 有 果 参 数 化 类 型 表示 一 个 + 生产 者 ， 就 是 用 <? extends t> 
; 如 果 它 表示 一 个 T 15 Bt 4 , 就 是 用 < super T> o 在 我 们 的 stack 
示例 中 ， pushAll 的 src 参数 产生 E 实例 供 Stack 使 用 ， 因此 src 
相应 的 类 型 为 Iterable<? extends E> ; popAll 的 dst 参数 通过 Stack 
消费 E 实例 ， 因此 dst 相应 的 类 型 为 Collection<? super E> ° PECS 这 
个 助 记 符 突 出 了 使 用 通配符 类 型 的 基本 原则 。Naftalin 和 Wadler 称 之 
为 Get and Put Principle [Naftalin07, 2.4] ° 


记 住 这 个 助 记 符 ， 我 们 下 面 来 看 一 些 之 前 的 条 目 中 提 到 过 的 方法 声 
明 3 第 25 条 中 的 reduce MEWA 这 条 声明 : 


static <E> E reduce (List<E>, list, Function<E> f, E initVal) 


虽然 列表 既 可 以 消费 也 可 以 产生 值 ， reduce 方法 还 是 只 用 它 的 list 
参数 作为 上 生产 者 (producer) ， 因 此 它 的 声明 就 应 该 使 用 一 个 


extends E 的 通配符 类 型 s 参数 f Rn E n DAVE Be BY AFE E 实 
例 的 函数 ， 因 此 通配符 类 型 不 适合 它 。 得 到 的 方法 声明 如 下 : 


// Wildcard type for parameter that serves as an E producer 
static <E> reduce(List<? extends E> list, Function<E> f, 


E initVal) 


这 一 变化 实际 上 有 什么 区 别 吗 ? 事实 上 ， 的 确 有 区 别 。 假 设 你 有 一 个 
List<Integer> , 想 通 过 Function<Number> 把 它 人 简化 z 它 不 能 通过 初始 声 


明 进 行 编译 ， 但 是 一 旦 添加 了 有 限制 的 通配符 类 型 ， 束 可 以 了 。 
现在 让 我 们 看 看 第 27 条 中 的 union 方法 。 下 面 是 声明 : 


public static <E> Set<E> union (Set<E> si, Set<E> s2) 


st 和 sz 这 两 个 参数 都 是 上 消费 者 ， 因 此 根据 PECS， 这 个 声明 应 
该 是 : 


public static <E> Set<E> union (Set<? extends E> s1, 


Set<? extends E> s2) 


注意 返回 类 型 仍然 是 set<e> , RBA WACPFRAYE AA ARA © KR 
了 为 用 户 提供 额外 的 灵 话 性 之 外 ， 它 还 会 强制 用 户 在 客户 端 代码 中 使 
用 通配符 类 型 。 


如 采 使 用 得 当 ， 通 配 符 类 型 对 于 类 的 用 户 来 说 几乎 是 无 形 的 。 它 们 使 
方法 能 够 接受 它们 应 该 接受 的 参数 ， 并 拒绝 那些 应 该 拒绝 的 参数 。 妨 
RANA LAG EBACIFRE, RHVAPISCFE SE te o 


遗憾 的 是 ， 类 型 推导 (type inference) 规则 相当 复杂 ， 在 语言 规范 中 
占 了 整整 16 页 [JLS，15.12.2.7-8]， 而 且 它 们 并 非 总 能 完成 需要 它们 完 


成 的 工作 。 看 看 修改 过 的 union 声明 ， 你 可 能 会 以 为 可 以 像 这 样 编 
T: 


Set<Integer> integers =... ; 
Set<Double> doubles = ... ; 


Set<Number> numbers = union(integers, doubles); 


(IX Z ile 2 FERRE a: 
Union.java: 14 : incompatible types 
found : Set<Number & Comparable<? extends Number & 
Comparable<?>>> 
required: Set<Number> 


Set<Number> numbers = union(integers, doubles); 


SJB, APD AY PACD MER o URE as KBE TE (0 
望 它 拥 有 的 类 型 ， 可 以 通过 一 个 BAIA (explicit type 
parameter) 来 告诉 它 要 使 用 哪 种 类 型 。 这 种 情况 不 太 经 常 发 生 ， 这 是 
好 事 ， 因 为 显 式 的 类 型 参数 不 太 优雅 。 增 加 了 这 个 显 式 的 类 型 参数 之 
后 ， 程 序 可 以 正确 无 误 地 进行 编译 : 


Set<Number> numbers = Union.<Number>union(integers, doubles); 


ETR, BUTBER AAT m A TEIA 
HH. 


public static <T extends Comparable<T>> T max (List<T> list) 


下 面 是 修改 过 的 使 用 通配符 类 型 的 声明 : 
public static <T extends Comparable<? super T>> T max ( 


Lists? extends T>- list) 


为 了 从 初始 声明 中 得 到 修改 后 的 版 本 ， 要 应 用 PECS 转 换 两 次 。 最 直接 
的 是 运用 到 参数 list 。 它 产生 + 实例 ， 因 此 将 类 型 从 Listers 改 成 
List<? extends T> © 更 灵活 的 是 运用 到 类 型 参数 T ° 这 是 我 们 第 一 次 
见 到 将 通配符 运用 到 类 型 参数 。 最 初 + 被 指定 用 来 扩展 comparabiect> 
， 但 是 + AY comparable 消费 + 实例 (并 产生 表示 顺序 的 整 值 ) 
HE, 参数 化 类 型 Comparable<T> 被 有 限制 通配符 类 型 Comparable<? super 
t> 取代 。 comparable 始终 是 消费 者 ， 因 此 EARME 
Comparable<? super T> EF Comparable<T> 2 对 于 comparator 也 一 样 ， 


因此 FEA AT BAN IKE Comparable<? super T> EF Comparable<T> 2 


修改 过 的 max 声明 可 能 是 整 本 书 中 最 复杂 的 方法 声明 了 “。 所 增加 的 复 
杂 代 码 真 的 起 作用 了 吗 ? 征 的 ， 起 作用 了 “。 下 面 是 一 个 简单 的 列表 示 
例 ， 在 初始 的 声明 中 不 允许 这 样 ， 修 改过 的 版 本 则 可 以 : 


List<ScheduledFuture<?>> scheduledFutures = ... ; 


不 能 将 初始 方法 声明 运用 给 这 个 列表 的 原因 在 于 ， 
java.util.concurrent.ScheduledFuture 没有 实现 Comparable<ScheduledFuture> 接 
O 9 相反 ， 它 是 扩展 Comparable<Delayed> 接口 的 Delayed 接口 的 子 接 

O o 换 人 句 话说 ， ScheduledFuture 示例 并 非 只 能 与 其 他 ScheduledFuture 示 
例 相 比较 ; 它 可 以 与 任何 pelayed 实例 相 比 较 ， 这 就 足以 导致 初始 声 
AAR i IBLE o 


修改 过 的 max 声明 有 一 个 小 小 的 问题 ， 它 阻止 方法 进行 编译 。 下 面 的 
方法 包含 了 修改 过 的 声明 : 


// Won't compile - wildcards can require change in method body! 
public static <T extends Comparable<? super T>> T max ( 
Last<? extends T> list) { 
Iterator<T> i = list.iterator(); 
T result = i.next(); 

while (i.hasNext()) { 


T t = i.next(); 


if (t.compareTo(result) > © ) 


return result; 


A TEEME Sr EERIE IS: 
Max.java:7: incompatible types 
found : Iterator<capture#591 of ? extends T> 
required: Iterator<T> 


Iterator<T> i = list.iterator(); 


这 条 错误 消息 意味 着 什么 ， 我 们 又 该 如 何 修正 这 个 问题 呢 ? 它 意味 着 
list 不 是 一 个 List<T> , 因此 它 的 iterator 方法 没有 返回 Iterator<T> 
o ERE + 的 某 个 子 类 型 的 一 个 iterator ， 因 此 我 们 用 它 代替 
iterator 声明 ， 它 使 用 了 一 个 有 限制 的 通配符 类 型 : 


Iterator<? extends T> i = list.iterator(); 


TX EL AIT TIE ABP LAME Eo TAT CARA next 方法 返回 的 元 又 
属于 + 的 某 个 子 类 型 ， 因 此 它们 可 以 被 安全 地 保存 在 类 型 + 的 一 个 


AR ge HH o 


还 有 一 个 与 通 配 答 有 关 的 话题 值得 探讨 。 类 型 参数 和 通配符 之 间 具 有 
双重 性 ， 许 多 方法 都 可 以 利用 其 中 一 个 或 者 另 一 个 进行 声明 。 例 如 ， 
下 面 是 可 能 的 两 种 静态 方法 声明 ， 来 交换 列表 中 的 两 个 被 索引 的 项 
ees Sian) Se 
JIH ALIT: 


// Two possible declarations for the swap method 
public static <E> void swap (List<E> list, int i, int j) ; 


public static void Swap (List<?> list, int i, int j) ; 


你 更 喜欢 两 种 方法 中 的 哪 一 种 呢 ? 为 什么 ? 在 公共 API 中 ， 第 二 种 更 
好 一 下 ， 因 为 它 更 简单 。 将 它 传 到 一 个 列表 中 一 任何 列表 方法 
就 会 交换 被 索引 的 元 素 。 不 用 担心 类 型 参数 。 一 般 来 说 ， 如 更 类 型 参 
MERE HHI, BEML PBOCE: © UBER BLK 
型 参数 ， 就 用 无 限制 的 通配符 取代 它 ， 如 果 是 有 限制 的 类 型 参数 ， 就 
用 有 限制 的 通配符 取代 它 。 


将 第 二 种 声明 用 于 swap 方法 会 有 一 个 问题 ， 它 优先 使 用 通配符 而 非 
类 型 参数 : 下 面 这 个 简单 的 实现 都 不 能 编译 : 


public static void swap (Last<?7> list, ant 2, int 7) { 


list.set(i, list.set(j, list.get(i))); 


Tee a EY SP EARRA IT A ASD PS ERY ek 
Swap.java:5: set(int,capture#282 of ?) in List<capture#282 of ?> 


cannot be applied to (int,Object) 


list.set(i, list.set(j, list.get(i))); 


不 能 讲 元 素 放 回 到 刚刚 从 中 取出 的 列表 中 ， 这 似乎 不 太 对 劲 。 问 题 在 

于 list 的 类 型 为 iste ， 你 不 能 把 ma 之 外 的 任何 值 放 到 List<? 

> 中 。 笠 运 的 是 ， 有 一 种 方式 可 以 实现 这 个 方法 ， 无 需求 助 于 不 安全 

的 转换 或 者 原生 态 类 型 (raw type) 。 这 种 想法 就 是 编写 一 个 私有 的 辅 

E 
这 样 : 


public static void Swap (List<?> list, int i, int J) { 


swapHelper(list, i, j); 


// Private helper method for wildcard capture 


private static <E> void swapHelper (List<E> list, int i, int j) { 


list.set(i, list.set(j, list.get(i))); 


swapHelper 方法 知道 list 是 一 个 List<E> S 因此 ， 它 知 道 从 这 个 列表 
中 取出 的 任何 值 均 为 上 类 型 ， 并 且 知 道 将 E 类 型 的 任何 值 放 进 列表 
都 是 安全 的 。 swap 这 个 有 些 费 解 的 实现 编译 起 来 却 是 正确 无 误 的 。 

它 允 许 我 们 导出 swap 这 个 比较 好 的 基于 通配符 的 声明 ， 同 时 在 内 部 
利用 更 加 复杂 的 泛 型 方法 。 swap 方法 的 客户 端 不 一 定 要 面 对 更 加 复 

杂 的 swapnelper 声明 ， 但 是 它们 的 确 从 中 受益 。 


总 而 言 之 ， 在 API 中 使 用 通配符 类 型 虽然 比较 需要 技巧 ， 但 是 使 API 变 
得 灵活 的 多 。 如 果 编 写 的 是 将 被 广泛 使 用 的 类 库 ， 则 一 定 要 适当 地 利 
用 通配符 类 型 。 记 住 基 本 的 原则 : producer-extends，consumer- 

super(PECS) 2 还 要 记 住 所 有 的 comparable 和 comparator 都 是 消费 者 g 


-a 优先 考虑 类 型 安全 的 异 构 容 


泛 型 最 常用 于 集合 ， 如 set 和 map ， 以 及 单元 素 的 容器 。 如 

ThreadLocal 和 AtomicReference 人 在 这 些 用 法 中 ， 它 都 充当 被 参数 化 了 
的 容器 。 这 样 就 限制 你 每 个 容 磺 只 能 有 固定 数目 的 类 型 参数 。 一 般 来 
说 ， 这 种 情况 正 是 你 想 要 的 。 一 个 see 只 有 一 个 类 型 参数 ， 表 示 它 的 
e 一 个 map 有 两 个 类 型 参数 ， 表 示 它 的 键 和 值 类 型 ， 诸 如 此 


但 是 ， 有 时 候 你 会 需要 更 多 的 灵活 性 。 例 如 ， 数 据 库 行 可 以 有 任意 多 
的 列 ， 如 采 能 以 类 型 安全 的 方式 访问 所 有 列 就 好 了 。 往 运 的 是 ， 有 一 
种 方法 可 以 很 容易 地 做 到 这 一 点 。 这 种 想法 就 是 将 E (key) 进行 参 
数 化 而 不 是 将 Ar (container) 参数 化 。 然 后 将 参数 化 的 键 提交 给 容 
顷 ， 来 插入 或 者 获取 值 。 用 泛 型 系统 来 确保 值 的 类 型 与 它 的 键 相符 。 


简单 地 示范 一 下 这 种 方法 : 考虑 Favorites 类 ， 它 人 允许 客户 端 从 任意 
数量 的 其 他 类 中 ， 保 存 并 获取 一 个 “最 喜爱 ”的 实例 。 cias WRITS 
参数 化 键 的 关键 部 分 。 之 所 以 可 以 这 样 ， 是 因为 类 class 在 Java 1.5 
版 本 中 被 泛 型 化 了 。 类 的 类 型 从 字面 上 来 看 不 再 只 是 简单 的 class ， 
而 是 Class<T> 村 例如 ， String.class 属于 Class<String> 类 型 ， 
Integer.class 属于 Class<Integer> 类 型 S 当 一 个 类 的 字面 文字 被 用 在 方 
法 中 ， 来 传达 编译 时 和 运行 时 的 类 型 信息 是 ， 就 被 称 作 type token 
[Brancha04] ° 


Favorites ZEA API4§ fE E 0 EAERI -个 人 简单 的 map > 除了 键 
(而 不 是 map) 被 参数 化 之 外 。 客 户 端 在 设置 和 获取 最 喜爱 的 实例 时 
提交 class 对象。 下面 束 是 这 个 API: 
// Typesafe heterogeneous container pattern - API 
public class Favorites { 


public <T> void putFavorite (Class<T> type, T instance) ; 


public <T> T getFavorite (Class<T> type) ; 


BE TR FE 检验 一 下 Favorites = 它 保 存 、 获取 并 打印 
一 个 最 喜爱 的 String ` Integer 和 Class 实例 : 


// Typesafe heterogeneous container pattern - client 

public static void main (String[] args) { 
Favorites f = new Favorites(); 
f.putFavorite(String.class, "Java" ); 
f.putFavorite(Integer.class, Oxcafebabe ); 
f.putFavorite(Class.class, Favorites.class); 
String favoriteString = f.getFavorite(String.class); 

int favoriteInteger = f.getFavorite(Integer.class); 

Class<?> favoriteClass = f.getFavorite(Class.class); 


System.out.printf( "%s %x %s%n" , favoriteString, 


favoriteInteger, favoriteClass.getName()); 


正如 所 料 ， 这 段 程序 打印 出 的 是 Java cafebabe Favorites ° 


Favorites 实例 是 ee (typesafe ) 的 : 当 你 辐 它 请 求 String 的 
时 候 ， 它 从 来 不 会 返回 一 个 integer 给 你 。 同 时 它 也 是 FAI 
(heterogeneous) : 不 像 普通 的 map， 它 的 所 有 键 都 是 不 同类 型 的 。 
因此 ， 我 们 将 Favorites 称 作 RB KEMPE ae (typesafe 
heterogeneous container) ° 


Favorites 的 实现 小 得 出 奇 。 它 的 完整 实现 如 下 : 
// Typesafe heterogeneous container pattern - implementation 
public class Favorites { 
private Map<Class<?>, Object> favorites = 


new HashMap<Class<?>, Object>(); 


public <T> void putFavorite (Class<T> type, T instance) { 
if (type == null ) 
throw new NullPointerException( "Type is null" ); 


favorites.put(type, instance); 


public <T> getFavorite(Class<T> type) { 


return type.cast(favorites.get(type)); 


这 里 发 生 了 一 些微 妙 的 事情 。 每 个 Favorites 实例 都 得 到 一 个 称 作 
favorites 的 私有 Map<Class<?>, Object> 的 支持 。 你 可 能 认为 由 于 无 限 通 
配 符 类 型 的 关系 ， 将 不 能 把 任何 东西 放 进 这 个 wap 中， 但 事实 正好 相 
反 。 要 注意 的 是 通配符 类 型 是 内 套 的 : 它 不 是 属于 通配符 类 型 的 map 
的 类 型 ， 而 是 它 的 键 的 类 型 。 由 此 可 见 ， 每 个 键 都 可 以 有 一 个 不 同 的 
参数 化 类 型 . 一 个 可 以 是 Class<String> , 接 下 来 是 Class<Integer> 等 
等 。 异 构 就 是 从 这 里 来 的 。 


第 二 件 要 注意 的 事情 是 ， favorites Map 的 值 类 型 只 能 是 Object © 换 句 

话说 ， map 并 不 能 保证 键 和 值 之 间 的 类 型 天 系 ， 即 不 能 保证 每 个 值 的 

类 型 都 与 键 的 类 型 相同 。 事 实 上 ， sava 的 类 型 系统 还 没有 强大 到 足 
a m a a a a 
这 一 点 o 


putFavorite APTAAVSCU Rin: 它 只 是 把 (从 指定 的 class 对 象 到 指 
定 的 favorite 实例 的 ) — “SERA THN favorites 中 如 前 所 壕 ， 这 十 
放弃 了 键 和 值 之 间 的 “类 型 联系 >?， 因 此 无 法 知道 这 个 值 是 键 的 一 个 实 
See ee 


getFavorite 方法 的 实现 比 putFavorite 的 更 难 一 些 © 它 先 从 favorites 
映射 中 获得 与 指定 crass 对 象 相对 应 的 值 。 这 正 是 要 返回 的 对 象 引 
用 ， 但 它 的 编译 时 类 型 是 错误 的 。 它 的 类 型 只 是 object (favorites 
映射 的 值 类 型 ，， 我 们 需要 返回 一 个 + 。 因 此 ， eetravorite 方法 的 
实现 利用 caass 的 cast 方法 ， 将 对 象 引 用 saa (dynamically 
cast) 成 了 class 对 象 所 表示 的 类 型 。 


cast 方法 是 Java 的 cast 操作 符 的 动态 模拟 。 它 只 检验 它 的 参数 是 
BA cass 对 象 所 表示 的 类 型 的 实例 。 如 果 是 ， 束 返回 参数 ;否则 残 


抛 出 ClassCastException 异常 。 我 们 知道 ， getFavorite 中 的 Cast 调用 
永远 也 不 会 抛 出 ClassCastException FE ， 并 假设 客户 端 代码 正确 无 误 
地 进行 了 编译 。 也 就 是 说 ， 我 们 知道 ravorites 映射 中 的 值 会 始终 与 
键 的 类 型 相 匹配 。 


假设 cast 方法 只 返回 它 的 参数 ， 那 它 能 为 我 们 做 什么 呢 ? cast 方 
法 的 签名 充分 利用 了 caass 类 型 被 泛 型 化 的 这 个 事实 。 它 的 返回 类 型 
是 Class 对 象 的 类 型 参数 : 


public class Class <T> { 


T cast (Object obj) ; 


这 正 是 getravorite 方法 所 需要 的 ， 也 正 是 让 我 们 不 必 借 助 于 未 受 检 地 
转换 成 T 就 能 确保 Favorites 类 型 安全 的 东西 ° 


ravorites 类 有 了 两 种 局 限 性 值得 注意 。 首 先 ， 恶 意 的 客户 端 可 以 很 轻松 
地 破坏 Favorites 实例 的 类 型 安全 ， 只 要 以 它 的 原生 态 类 型 (ray 
form) 使 用 clas。 对 象 。 但 会 造成 客户 端 代码 在 编译 时 产生 未 受 检 的 
警告 。 这 和 与 一 般 的 集合 实现 ， 如 Hashset 和 nasa 并 没有 什么 区 

别 。 也 就 是 说 ， 如 果 愿意 付出 一 点 点 代价 ， 就 可 以 拥有 运行 时 的 类 型 
TE ° MR Favorites 永远 不 违背 它 的 类 型 约束 条 件 的 方式 是 ， 让 
putFavorite 方法 检验 instance 是 否 真 的 是 type 所 表示 的 类 型 的 实 
例 。 我 们 已 经 知道 这 要 如 何 进行 了 ， 只 要 使 用 一 个 动态 的 转换 : 


// Achieving runtime type safty with a dynamic cast 


public <T> void putFavorite (Class<T> type, T instance) { 


favorites.put(type, type.cast(instance)); 


java.util.collectios 中 有 一 些 集 合 包 装 类 采用 了 同样 的 技巧 。 它 们 称 
作 checkedSet `~ checkedList `~ checkedMap , 诸如 此 类 。 除了 一 个 集合 
(或 者 映射 ， 之 外 ， 它 们 的 静态 工厂 还 采用 一 个 (或 者 两 个 ) class 

WR RSL BIZ AE, MIR cass 对 象 和 集合 的 编译 时 类 型 
相 匹 配 。 包 装 类 给 它们 所 封装 的 集合 增加 了 具体 化 。 例 如 ， 如 果 有 人 
视图 将 Coin 放 进 你 的 Collection<Stamp> , 包装 类 就 会 在 运行 时 抛 出 

ClassCastException 异常 用 这 些 包 装 类 在 混 油 泛 型 和 遗留 代码 的 应 用 
程序 中 追溯 “ 谁 把 错误 的 类 型 元 陛 添 加 到 了 集合 中 ”很 有 帮助 。 


Favorites 类 的 第 二 种 局 限 性 在 于 它 不 能 用 在 不 可 具体 化 的 (non- 
reifiable) 类 型 中 ( 见 第 25 条 ) 。 换 句 话 说， 你 可 以 保存 最 喜爱 的 
String 或 者 String[] ， 但 不 能 保存 最 喜爱 的 List<String> o 如果 试图 
保存 最 喜爱 的 List<string> ， 程 序 束 不 能 进行 编译 .原因 在 于 你 无 法 为 
List<String> 获得 一 个 Class WE: List<String>.class 是 个 语法 错误 ， 
这 也 是 件 好 事 。 List<String> 和 List<Integer> 共用 一 个 Class 对 象 ， 
BU List.class o 如果 从 “字面 (type literal) ”上 来 看 ， 

List<String>.class 和 List<Integer>.class 是 合法 的 ， 并 返回 了 相同 的 对 
RIH, TLS AID Favorites 对 象 的 内 部 结构 


对 于 第 二 种 局 限 性 ， 还 没有 完全 令 人 满意 的 解决 办 法 。 有 一 种 方法 称 
作 super type token， 它 在 解决 这 一 局 限 性 方面 做 了 很 多 努力 ， 但 是 这 
种 方法 仍然 有 它 目 映 的 局 限 性 [Gafter07] 。 


Favorites 使 用 的 类 型 令 牌 (type token) 是 无 限制 的 : getFavorite 和 
putFavorite 接受 任何 class 对 象 。 有 时 候 ， 可 能 需要 限制 那些 可 以 传 
给 方法 的 类 型 。 这 可 以 通过 有 限制 的 类 型 令 脾 (bounded type token) 
来 实现 ， 它 只 是 一 个 类 型 令 牌 ， 利 用 有 限制 类 型 参数 ( 见 第 27 条 ) 或 
者 有 限制 通配符 ( 见 第 28 条 ) ， 来 限制 可 以 表示 的 类 型 。 


注解 API 〈 见 第 35 条 ) 广泛 利用 了 有 限制 的 类 型 令 牌 。 例 如 ， 这 是 一 
个 在 运行 时 读 取 注 解 的 方法 ° 这 个 方法 来 目 AnnotatedElement 接口 T 
通过 表示 类 、 方 法 、 域 及 其 他 程序 元 素 的 反射 类 型 来 实现 : 


public <T extends Annotation> 


T getAnnotation (Class<T> annotationType) ; 


参数 annotationtype 是 一 个 表示 注解 类 型 的 有 限制 的 类 型 令 牌 。 如 采 元 
素 有 这 种 类 型 的 注解 ， 该 方法 就 将 它 返 回 ， 如 果 没 有 ， 则 返回 mu 
en eee ar) BE TIERA 


假设 你 有 一 个 类 型 cass 的 对 象 ， 并 且 想 将 它 传递 给 一 个 需要 有 限 
制 的 类 型 令 牌 的 方法 ， 例 如 getannotation 。 你 可 以 将 对 象 转化 成 
Class<? extends Annotation> , 但 是 这 种 转换 时 非 受 检 的 ， 因此 会 产生 一 
条 编译 时 警告 ( 见 第 24 条 ) ° WANE, K cass 提供 了 一 个 安全 
(EID) 地 执行 这 种 转换 的 实例 方法 。 该 方法 称 作 assubclass ， 它 
将 调用 它 的 cass 对 象 转换 成 用 其 他 参数 表示 的 类 的 一 个 子 类 。 如 果 
转换 成 功 ， 该 方法 返回 它 的 参数 ; 如 果 失 败 ， 则 抛 出 ClassCastException 


已 Ae 
JE ° 


以 下 示范 了 如 何 利用 assubclass 方法 在 编译 时 读 取 类 型 未 知 的 注解 。 
这 个 方法 编译 时 没有 出 现 错误 或 者 警告: 


// Use of asSubclass to safely cast to a bounded type token 


static Annotation getAnnotation (AnnotatedElement element, 


String annotationTypeName ) { 


Class<?> annotationType = null ; // Unbounded type token 


try Ei 


annotationType = Class.forName(annotationTypeName) ; 


} catch (Exception ex) { 


throw new IllegalArgumentException(ex); 


return element.getAnnotation( 


annotationType.asSubclass(Annotation.class)); 


AM BZ, RAAPIA S12 AAS, BRR BET Are A ER 
fa EBL A AVA o PRAY DAI RAS ONE E E Ne A a 
FRET IX — BR il] e WIR ae RASA, PAH cass 对象 
作为 键 。 以 这 种 方式 使 用 的 crass 对 象 称 作 类 型 令 牌 。 你 也 可 以 使 用 
定制 的 键 类 型 © 例如， 用 一 个 patabasepow 类 型 表示 一 个 数据 库 行 〈 容 
器 ) ， 用 泛 型 colm<r 作为 它 的 键 。 


第 6 章 枚 举 和 注解 


Java 1.5 发 行 版 本 中 增加 了 两 个 新 的 引用 类 型 家 族 : 一 种 新 的 类 称 作 
MERA (enum type) ， 一 种 新 的 接口 称 作 EMP AA! (annotation 
type) 。 本 章 讨 论 使 用 这 两 个 新 的 类 型 家 族 的 最 佳 实践 。 


第 30 条 : 用 enum 代替 int 常量 


MERA! (enum type) 是 指 由 一 组 固定 的 常量 组 成 合法 值 的 类 型 ， 例 
如 一 年 中 的 季 订 、 太 阳 系 中 的 行星 或 者 一 副 牌 中 的 花色 。 在 编程 语言 
还 没有 引入 枚 举 类 型 之 前 ， 表 示 枚 举 类 型 的 常用 模式 是 声明 一 组 具名 


的 ane 常量 ， 每 个 类 型 成 员 一 个 常量 


// The int enum pattern - severely deficient! 


public static final int APPLE_FUJI = 0; 


public static final int APPLE_PIPPIN = 


public static final int APPLE_GRANNY_SMITH = 2 ; 


public static final int ORANGE_NAVEL = 0; 


public static final int ORANGE_TEMPLE = 1 ; 


public static final int ORANGE_BLOOD = 2; 


这 种 方法 称 作 intre (intenum pattem) ， 存 在 着 诸多 不 足 。 它 
在 类 型 安全 性 和 使 用 方便 性 方面 没有 任何 帮助 。 如 采 你 将 apple 传 到 
想 要 orange 的 方法 中 ， 编 译 絮 也 不 会 出 现 警告 ， 还 会 使 用 == 操作 符 
将 apple 与 orange 进行 对 比 ， 甚 至 更 糟糕 : 


// Tasty citrus flavored applesauce! 


int i = (APPLE _ FUJI - ORANGE_TEMPLE) / APPLE_PIPPIN; 


注意 每 个 apple 常量 的 名 称 部 以 a ENIR, A orange $ EN) 
都 以 opawes ”作为 前 缀 。 这 是 因为 Java 没有 为 int 枚 举 组 提供 命名 
空间 。 当 两 个 int 枚 举 组 具有 相同 的 明明 常量 时 ， 前 缀 可 以 防止 名 称 
发 生 冲 突 。 


采用 ant 枚 举 模式 的 程序 是 身份 脆弱 的 。 因 为 int 枚 举 是 编译 时 第 
量 ， 被 编译 到 使 用 它们 的 客户 端 中 。 如 采 域 枚 举 常 量 关 联 的 int KE 
了 变化 ， 客 户 端 藉 必须 重新 编译 。 如 采 没 有 重 痢 编 译 ， 程 序 还 是 可 以 
运行 ， 但 是 它们 的 行为 束 是 不 确定 的 。 


将 int 枚 举 常 量 翻译 成 可 打印 的 字符 串 ， 并 没有 很 便利 的 方法 。 如 果 
将 这 种 当量 打印 出 来 ,或 者 从 调试 器 中 将 它 显示 出 来 ， 你 所 见 到 的 下 
古 一 个 数字 ， 这 没有 太 大 的 用 处 。 要 届 历 一 个 组 中 的 所 有 int MER 
量 ， 甚 至 获得 int 枚 举 组 的 大 小 ， 这 些 都 没有 很 可 靠 的 方法 。 


你 还 可 能 碰 到 这 种 模式 的 变 体 ， 在 这 种 模式 中 使 用 的 是 string HÆ, 
而 不 是 int 常量 。 这 样 的 变 体 补 称 作 strig MER, IŽE ER 
们 最 不 期 望 的 。 虽 然 它 为 这 些 稼 量 提 供 了 可 打印 的 字符 串 ， 但 十 它 会 
导致 性 能 问题 ， 因 为 它 依赖 于 字符 串 的 比较 操作 。 更 糟糕 的 是 ， 它 会 
导致 初级 用 户 把 字符 第 创 两 便 编 码 到 客户 端 代码 中 ， 而 不 是 使 用 适当 
的 域 (field) 名 。 如 果 这 样 的 硬 编 码 字 符 串 常量 中 包含 有 书写 错误 ， 


2 ， 这 样 的 错误 在 编译 时 不 会 被 检测 到 ， 但 是 在 运行 的 时 候 却 会 报 
it 。 


幸运 的 是 ， 从 Java 1.5 发 行 版 本 开始 ， 束 提出 了 男 一 种 可 以 奉 代 的 解 
决 方案 ， 可 以 避免 int 和 string BASRCU, Feito ab 
的 好 处 。 这 就 是 (JLS，8.9) 。 下 面 以 最 简单 的 形式 演示 了 这 种 模 


a 

public enum Apple { FUJI, PIPPIN, GRANNY_SMITH } 

public enum Orange { NAVEL, TEMPLE, BLOOD } 
表面 上 看 来 ， 这 些 枚 举 类 型 与 其 他 语言 中 的 没有 什么 两 样 ， 例 如 C、 
C++ 和 C#， 但 是 实际 上 并 非 如 此 。Java 的 枚 举 类 型 是 功能 十 分 齐全 的 
类 ， 功 能 比 其 他 语言 中 的 对 等 物 要 强大 得 多 ，Java 的 枚 举 本 质 上 是 


int 


Java 枚 举 类 型 背后 的 基本 想法 非常 答 单 : 它们 就 是 通过 公有 的 静态 
final 域 为 每 个 枚 举 常量 导出 实例 的 类 。 因 为 没有 可 以 访问 的 构造 
右 ， 枚 举 类 型 是 真正 的 tina 。 因 为 客户 端 既 不 能 创建 枚 举 类 型 的 实 
例 ， 也 不 能 对 它 进 行 扩展 ， 因 此 很 可 能 没有 实例 ， 而 只 有 声明 过 的 枚 
举 常量 。 换 句 话说 ， 枚 举 类 型 是 实例 受 控 的 。 它 们 是 单 例 

(Singleton) 的 泛 型 化 ( 见 第 3 条 ) ， 本 质 上 是 单元 素 的 枚 举 。 对 于 就 
悉 本 书 第 一 版 的 读者 来 说 ， 枚 举 类 型 为 KEZE (typesafe 
enum) 模式 [Bloch01， 见 第 21 条 ] 提 供 了 语言 方面 的 支持 。 


枚 举 提供 了 编译 时 的 类 型 安全 。 如 果 声 明 一 个 参数 的 类 型 为 Apple ， 

就 可 以 保证 ， 被 传 到 该 参数 上 的 任何 非 nu 的 对 象 引 用 一 定 属于 三 
个 有 效 的 apie 值 之 一 。 试 图 传递 类 型 错误 的 值 时 ， 会 寻 致 编译 时 错 
误 ， 吏 像 试 图 将 某 种 枚 举 类 型 的 表达 式 赋 给 男 一 种 枚 举 类 型 的 变量 ， 

或 者 试图 利用 == 操作 符 比 较 不 同 枚 举 类 型 的 值 一 样 。 


包含 同名 常量 的 多 个 枚 举 类 型 可 以 在 一 个 系统 中 和 平 共处 ， 因 为 每 个 
类 型 都 有 自己 的 命名 空间 。 你 可 以 增加 或 者 重新 排列 枚 举 类 型 中 的 党 
量 ， 而 无 需 重新 编译 它 的 客户 端 代码 ， 因 为 导出 常量 的 域 在 枚 举 类 型 
和 它 的 客户 端 之 间 提 供 了 一 个 隔离 层 ， 常 量 值 并 没有 被 编译 到 客户 端 


代码 中 ， 而 是 在 int 枚 举 模式 中 。 最 终 ， 可 以 通过 调用 tostring 77 
法 ， 将 枚 举 转 换 成 可 打印 的 字符 串 。 


BRT SCE TS im 枚 举 模式 的 不 足 之 处 ， 枚 举 类 型 还 允许 添加 人 的 方法 
和 域 ， 并 实现 任意 的 接口 。 它 们 提供 了 所 有 object 方法 (DLS) 
的 高 级 实现 ， 实现 了 Comparable ( 见 第 12 条 ) 和 Serializable 接口 
( 见 第 11 章 ) ， 并 针对 枚 举 类 型 的 可 任意 改变 性 设计 了 序列 化 方式 。 


那么 我 们 为 什么 要 将 方法 或 者 域 添 加 到 枚 举 类 型 中 昵 ? IC, URED BE 
征 想 将 数据 与 它 的 常量 关联 起 来 。 例 如 ， 一 个 能 够 返回 水 条 颜色 或 者 
返回 水 采 图 片 的 方法 ， 对 于 我 们 的 appe 和 orange 类 型 来 说 可 能 很 
有 好 处 。 你 可 以 利用 任何 适当 的 方法 来 增强 枚 举 类 型 。 枚 举 类 型 可 以 
a ieee Ee a 


举 个 有 关 枚 举 类 型 的 好 例子 ， 比 如 太阳 系 中 的 8 颗 行 星 。 每 颗 行星 都 有 
质量 和 半径 ， 通 过 这 两 个 属性 可 以 计算 出 它 的 表面 重力 。 从 而 给 定 物 
体 的 质量 ， 头 可 以 计算 出 一 个 物体 在 行星 表面 上 的 重量 。 下 面 束 是 这 
个 枚 举 。 每 个 枚 举 第 量 后 面 括 号 中 的 数值 束 是 传递 给 构造 右 的 参数 。 
在 这 个 例子 中 ， 它 们 就 是 行星 的 质量 和 半径 : 


// Enum type with data and behavior 


public enum Planet { 


MERCURY( 3.302e+23 , 2.439e6 ), 


VENUS ( 4.869e+24 , 6.052e6 ), 


EARTH ( 5.975e+24 , 6.378e6 ), 


MARS ( 6.419e+23 , 3.393e6 ), 


JUPITER( 1.899e+27 , 7.149e7 ), 


SATURN ( 5.685e+26 , 6.027e7 ), 


URANUS ( 8.683e+25 , 2.566e7 ), 


NEPTUNE( 1.024e+26 , 2.477e7 ); 


private final double mass; // In kilograms 


private final double radius; // In meters 


private final double surfaceGravity; // In m / s^2 


// Universal gravitational constant in m3 / kg s^2 


private static final double G = 6.67300E-11 ; 


// Constructor 


Planet( double mass, double radius) { 


this .mass = mass; 


this .radius = radius; 


surfaceGravity = G * mass / (radius * radius); 


public double mass () { return mass; } 


public double radius () { return radius; } 


public double surfaceGravity () { return surfaceGravity; } 


public double surfaceWeight ( double mass) { 


return mass * surfaceGravity; // F = ma 


编写 一 个 像 planet 这 样 的 枚 举 类 型 并 不 难 。 A TPS MAS i E 
KBER, PAA LAW, HAS — Tit GEIR PTE P 
IEAS ° WSR EA FE, AAT AAR IAAT final 的 
( 见 第 15 条 ) 。 它 们 可 以 是 公有 的 ,但 最 好 将 它们 做 成 是 私有 的 ， 并 
提供 公有 的 访问 方法 ( 见 第 14 条 ) 。 在 planet 这 个 示例 中 ， 构 造 器 还 
计算 和 保存 表面 重力 ， 但 这 正 是 一 种 优化 。 每 当 surtaceweignt 方法 用 
到 重力 时 ， 都 会 根据 质量 和 半径 重新 计算 ， 并 返回 它 在 该 常量 所 表示 
的 行星 上 的 重量 。 


HOR planet 枚 举 很 创 单 ， 它 的 功能 却 强 大 的 初期 。 下面 是 一 个 简短 的 
程序 ， 根 据 某 个 物体 在 地 球 上 的 重量 (以 任何 单位 ) ， 打 印 出 一 张 很 
棒 的 表格 ， 显 示 出 该 物体 在 所 有 8 颗 行 星 上 的 重量 (用 相同 的 单位 ) : 


public class WeightTable { 


public static void main (String[] args) { 


double earthWeight = Double.parseDouble(args[ 0 ]); 


double mass = earthWeight / Planet.EARTH.surfaceGravity(); 


for (Planet p : Planet.values()) 


System.out.printf( "Weight on %s is %f%n" , 


p, p.surfaceweight(mass)); 


注意 Planet 就 像 所 有 的 枚 举 一 样 ， 它 有 一 个 静态 的 Values 方法 ， fx 
照 声 明 顺 序 返 回 它 的 值 数 组 。 还 要 注意 tostring 方法 返回 每 个 枚 举 值 
的 声明 名 称 ， 使 得 println 和 printf 的 打印 变 得 更 加 容易 。 如 果 你 还 
不 满足 这 种 字符 串 表 示 法 ， 可 以 通过 禾 盖 tostring 方法 对 它 进行 修 
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Weight on MERCURY is 66.133672 


Weight on VENUS is 158.383926 


Weight on EARTH is 175.000000 


Weight on MARS is 66.430699 


Weight on JUPITER is 442.693902 


Weight on SATURN is 186.464970 


Weight on URANUS is 158.349709 


Weight on NEPTUNE is 198.846116 


如 果 这 是 你 第 一 次 在 实践 中 见 到 Java 的 pritt 方法 ， 要 注意 它 与 C 语 
言 的 区 别 ， 你 在 这 里 用 的 是 和 ， 在 C 中 则 用 wn ° 


与 枚 举 常 量 关 联 的 有 些 行为 ， 可 能 只 需要 用 在 定义 了 枚 举 的 类 或 者 包 
中 。 这 种 行为 最 好 被 古 现成 私有 的 或 者 包 级 私有 的 方法 。 于 是 ， 每 个 
枚 举 币 量 都 带 有 一 组 隐蔽 的 行为 ， 这 使 得 包含 该 枚 举 的 类 或 者 包 在 过 
到 这 种 第 量 时 都 可 以 做 出 适当 的 反应 。 束 像 其 他 的 类 一 样 ， 除 非 迫 不 
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的 ， 如 有 必要 ， 则 声明 为 包 级 私有 的 〈 见 第 13 条 ) 


如 果 一 个 枚 举 具有 普遍 适用 性 ， 它 就 应 该 成 为 一 个 顶层 类 (top-level 
class) ; 如 果 它 只 是 被 用 在 一 个 特定 的 顶层 类 中 ， 它 束 应 该 成 为 该 顶 
层 类 的 一 个 成 员 类 ( 见 第 22 条 ) o 例如， java.math.Roundingode 枚 举 表 
示 十 进 制 小 数 的 舍 入 模式 (rounding mode) 。 这 些 舍 入 模式 用 于 

Bigpecinal 类 ， 但 是 它们 提供 了 一 个 非常 有 用 的 抽象 ， 这 种 抽象 本 质 
上 又 不 属于 BigDecimal 类 ° 通过 使 RoundingMode 成 为 一 个 顶层 类 ， 库 
e n a 

|B} EJ — RUE ° 


planet IRAP IRIT ER TKS AMERRE RANE T, BRA 
时 候 会 需要 更 多 的 方法 。 每 个 planet 常量 都 关联 了 不 同 的 数据 ， 但 你 
有 时 需要 将 本 质 上 不 同 的 行为 (behavior) 与 每 个 常量 关联 起 来 。 例 
如 ， 假 设 你 在 编写 一 个 枚 举 类 型 ， 来 表示 计算 右 的 四 大 基本 操作 BE 
加 减 乘 除 ，， 你 想 要 提供 一 个 方法 来 执行 每 个 常量 所 表示 的 算术 运 
算 。 有 一 种 方法 是 通过 启用 枚 举 的 值 来 实现 ; 


// Enum type that switches on its own value - questionable 


public enum Operation { 


PLUS, MINUS, TIMES, DIVIDE; 


// Do th arithmetic op represented by this constant 


double apply ( double x, double y) { 


switch ( this ) { 


case PLUS: return x+y; 


case MINUS: return x - y; 


case TIMES: return x * y; 


case DIVIDE: return x / y; 


throw new AssertionError( "Unknown op: " + this ); 


这 段 代 码 可 行 ， 但 是 不 太 好 看 。 如 果 没 有 swith 语句 ， 它 就 不 BEA 
译 ， 虽 然 从 技术 角度 来 看 代码 的 结束 部 分 是 可 以 执行 到 的 ， 但 是 实际 
上 是 不 可 能 执行 到 这 行 代码 的 [ 蕊 S， 更 糟糕 的 是 ， 这 段 代 码 
很 脆弱 。 如 果 你 添加 了 新 的 枚 举 常 量 ， 却 忘记 给 switen 添加 相应 的 条 
i 枚 举 仍 然 可 以 编译 ， 但 是 当 你 试图 运 云 行 新 的 运算 时 ， 就 会 运行 失 
由 o 
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起 来 : 在 枚 举 类 型 中 声明 一 个 抽象 的 apply 方法 ， 并 在 FRET RAY 
ZL (constant-specific class body) "F, 用 具体 的 方法 覆盖 每 个 常量 
的 抽象 apply 方法 。 这 种 方法 被 称 作 FET EENID AEH 


(constant-specific method implementation) : 


// Enum type with constant-specific method implementations 


public enum Operation { 


PLUS { double apply ( double x, double y) { return x + y;} }, 


MINUS { double apply ( double x, double y) { return x - y;} }, 


TIMES { double apply ( double x, double y) { return x * y;} }, 


DIVIDE { double apply ( double x, double y) { return x / y;} }; 


abstract double apply ( double x, double y) ; 
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特定 于 常量 的 方法 实现 可 以 与 特定 于 常量 的 数据 结合 起 来 。 例 如 ， 下 
面 的 Operation fet S toString 来 返回 通常 与 该 操作 关联 的 符号 : 


// Enum type with constant-specific class bodies and data 


public enum Operation { 


PLUS( "+" ) { 


double apply ( double x, double y) { return x + y; } 


} 
MINUS( "-" ) { 

double apply ( double x, double y) { return x - y; } 
}, 


TIMES( "*" ) { 


double apply ( double x, double y) { return x * y; } 


}, 


DIVIDE( "/" ) { 
double apply ( double x, double y) { return x / y; } 
3; 
private final String symbol; 
Operation(String symbol) { this .symbol = symbol; } 


@Override public String toString () { return symbol; } 


abstract double apply ( double x, double y) ; 


在 有 些 情 况 下 ， 在 枚 举 中 覆盖 tostring 非常 有 用 。 例 如 ， 上 述 的 
tostring 实现 使 得 打印 算术 表达 式 变 得 非常 容易 ， 如 这 段 小 程序 所 
Z: 


public static void main (String[] args) { 


double x = Double.parseDouble(args[ 9 ]); 


double y = Double.parseDouble(args[ 1 ]); 


for (Operation op : Opetation.values()) 


System.out.printf( "%f %s %f = %f%n" , 


xX, Op, y, Op.apply(x, y)); 


用 2 和 4 作为 命令 行 参 数 运行 这 段 程序 后 ， 会 输出 : 


2.000000 + 4.000000 = 6.000000 
2.000000 - 4.000000 = - 2.000000 
2.000000 * 4.000000 = 8.000000 
2.000000 / 4.000000 = 0.500000 


枚 举 类 型 有 一 个 目 动产 生 的 valueOf (String) 方法 ， 它 将 常量 的 名 字 转 
变 成 为 前 量 本 身 。 如 果 在 枚 举 类 型 中 黎 盖 tostring ， 要 考虑 编写 一 个 
fromstring 方法 ， 将 定制 的 字符 串 表 示 法 变 回 相应 的 枚 举 。 下 列 代码 
(适当 地 改变 了 类 型 名 称 ) 可 以 为 任何 枚 举 完成 这 一 技巧 ， 只 要 每 个 
常量 都 有 一 个 独特 的 字符 串 表示 法 : 


// Implementation a fromString method on an enum type 


private static final Map<String, Operation> stringToEnum 


= new HashMap<String, Operation>(); 


static { // Initialize map from contant name to enum constant 


for (Operation op : values()) 


stringToEnum.put(op.toString(), op); 


// Returns Operation for String, or null if string is invalid 


public static Operation fromString (String symbol) { 


return stringToEnum.get(symbol) ; 


注意 ， 在 常量 被 创建 之 后 ， Operation 常量 从 静态 代码 块 中 被 放 入 到 

了 strangrocrun 的 nap 中。 试图 使 每 个 变量 都 从 自己 的 构造 器 将 自身 
放 入 到 mp 中 ， 会 导致 编译 时 错误 。 这 是 好 事 ， 因 为 如 果 这 是 合法 

的 ， 就 会 抛 出 nullpointerexception 异常 。 枚 举 构 造 器 不 可 以 访问 枚 举 的 
静态 域 ， 除 了 编译 时 常量 之 外 。 这 一 限制 是 有 必要 的 ， 因 为 构造 器 运 
行 的 时 候 ， 这 些 静 态 域 还 没有 被 初始 化 。 


特定 于 常量 的 方法 实现 有 一 个 美中不足 的 地 方 ， 它 们 使 得 在 枚 举 常 量 
中 共享 代码 变 得 更 加 困难 了 。 例 如 ， 考 虑 用 一 个 枚 举 表示 薪资 包 中 的 
工作 天 数 。 这 个 枚 举 有 一 个 方法 ， 根 据 给 定 某 工人 的 基本 工资 〈 按 小 
时 ) 以 及 当天 的 工作 时 间 ， 来 计算 他 当天 的 报酬 。 在 五 个 工作 日 中 ， 
超过 正常 八 小 时 的 工作 时 间 都 会 产生 加 班 工资 ， 在 双休日 中 ， 所 有 工 
作 都 产生 加 班 工资 。 利 用 switch 语句， 很 容易 通过 将 多 个 case 标签 
分 别 应 用 到 两 个 代码 请 段 中 ， 来 完成 这 一 计算 。 为 了 简洁 起 见 ， 这 个 
示例 中 的 代码 使 用 了 double , 但 是 注意 double 并 不 是 适合 薪资 应 用 
程序 ( 见 第 48 条 ) 的 数据 类 型 。 


// Enum that switches on its value to share code - questionable 


enum PayrollDay { 


MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, 


SATURDAY, SUNDAY; 


private static final int HOURS_PER_SHIFT = 8 ; 


double pay ( double hoursWorked, double payRate) { 


double basePay = hoursWorked * payRate; 


double overtimePay; // Calculate overtime pay 
switch ( this ) { 
case SATURDAY: case SUNDAY 
overtimePay = hoursWorked * payRate / 2 ; 
default : // Weekdays 
overtimePay = hoursWorked <= HOURS_PER_SHIFT ? 
© : (hoursWorked - HOURS_PER_SHIFT) * payRate / 2 ; 


break ; 


return basePay + overtimePay; 


不 可 否认 ， 这 段 代 码 十 分 简洁 ， 但 是 从 维护 的 角度 来 看 ， 它 十 分 危 
险 。 假 设 将 一 个 元 素 添 加 到 该 枚 举 中 ， 或 许 是 一 个 表示 假期 天 数 的 特 
殊 值 ， 但 是 起 记 给 switen 语句 添 加 相应 的 case。。 程 序 依然 可 以 编 
译 , 但 pay 方法 会 悄悄 地 将 假期 的 工资 计算 成 与 正常 工作 日 的 相同 。 


为 了 利用 特定 于 稼 量 的 方法 实现 安全 地 执行 工资 计算 ， 你 可 能 必须 重 
复 计算 每 个 常量 的 加 班 工资 ， 或 者 将 计算 移 到 两 个 辅助 方法 中 (一 个 
用 来 计算 工作 日 ， 一 个 用 来 计算 双休日 ) ， 并 从 每 个 常量 调用 相应 的 


辅助 方法 。 这 任何 一 种 方法 都 会 产生 相当 数量 的 样板 代码 ， 结 果 降 低 
了 可 读 性 ， 并 增加 了 出 错 的 机 率 。 


通过 用 计算 工作 日 加 班 工 资 的 具体 方法 代替 PayrollDay 中 抽象 的 
overtimePay 方法 ， 可 以 减少 样板 代码 。 这 样 ， 束 只 用 双休日 必须 履 盖 
该 方法 了 。 但 是 这 样 也 有 着 与 sten 语句 一 样 的 不 足 ， 如 果 有 增加 了 
一 天 而 没有 罗兰 overtimePay 方法 ， 就 会 悄悄 地 延续 工作 日 的 计算 o 
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(strategy enum) 的 实例 传 到 payrollpay 枚 举 的 构造 器 中 。 之 后 
payrollDay 枚 举 将 加 班 工资 计算 委托 给 策略 枚 举 ， PayrollDay HA LAS 
需要 switch 语句 或 者 特定 于 常量 的 方法 实现 了 。 虽 然 这 种 模式 没有 
switch 语句 那么 简洁 ， 但 更 加 安全 ， 也 更 加 有 灵活 : 


// The strategy enum pattern 


enum PayrollDay { 


MONDAY (PayType.WEEKDAY), TUESDAY(PayType.WEEKDAY), 


WEDNESDAY (PayType . WEEKDAY ) , THURSDAY (PayType . WEEKDAY), 


FRIDAY (PayType . WEEKDAY), 


SATURDAY (PayType .WEEKEND), SUNDAY (PayType .WEEKEND) ; 


private pay ( double hoursWorked, double payRate) { 


return payType.pay(hoursworked, payRate); 


// The strategy enum type 


private enum PayType { 


WEEKDAY { 


double overtimePay ( double hours, double payRate) { 


return hours <= HOURS_PER_SHIFT ? 0 


(hours - HOURS_PER_SHIFT) * payRate / 2 ; 


} 
}, 
WEEKEND { 
double overtimePay ( double hours, double payRate) { 
return hours * payRate / 2 ; 
it 
3; 


private static final int HOURS PER SHIFT = 8 ; 


abstract double overtimePay ( double hours, double payRate) ; 


double pay ( double hoursWorked, double payRate) { 


double basePay = hoursWorked * payRate; 


return basePay + overtimePay(hoursworked, payRate); 
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枚 举 不 受 你 的 控制 ， 你 希望 它 有 一 个 实例 方法 来 返回 每 个 运算 的 反 运 
算 。 你 可 以 用 下 列 静 态 方 法 模拟 这 种 效果 : 


// Switch on an enum to simulate a missing method 


public static Operation inverse (Operation op) { 


switch (op) { 


case PLUS: return Operation.MINUS; 


case MINUS: return Operation.PLUS; 


case TIMES: return Operation.DIVIDE; 


case DIVIDE: return Operation.TIMES; 


default : throw new AssertionError( "Unkown op: " + op); 


一 般 来 说 ， 枚 举 会 优先 使 用 comparable 而 非 int i a 5 int i 
相 比 ， 枚 举 有 个 小 小 的 性 能 缺点 ， 即 装 在 和 初始 化 枚 举 时 会 有 空间 和 
时 间 的 成 本 。 除 了 受 资源 约束 的 设备 ， 例 如 手机 和 烤 面 包机 之 外 ， 在 
实践 中 不 必 太 在 意 这 个 问题 。 


那么 什么 时 候 应 该 使 用 枚 举 呢 ? 每 当 需 要 一 组 固定 常量 的 时 候 。 当 
然 ， 这 包括 “天 然 你 的 枚 举 类 型 *， 例 如 行星 、 一 周 的 天 数 以 及 棋子 的 
数目 等 等 。 但 它 也 包括 你 在 编译 时 就 知道 其 所 有 可 能 值 的 其 他 集合 ， 
例如 菜单 的 选项 、 操 作 代 码 以 及 命令 行 标 记 等 。 枚 举 类 型 中 的 常量 集 
并 不 一 定 要 始终 保持 不 变 。 专 门 设计 枚 举 特性 是 考虑 到 枚 举 类 型 的 二 
进 制 兼容 演变 。 


AWAZ, F it 常量 相 比 ， 枚 举 类 型 的 优势 十 不 言 而 喻 的 。 枚 举 要 
易 读 得 多 ， 也 更 加 安全 ， 功 能 更 加 强大 。 许 多 枚 举 都 不 需要 显 式 的 构 

造 器 或 者 成 员 ， 但 许多 其 他 枚 举 则 受益 于 “每 个 常量 与 属性 的 关联” 以 

及 “提供 行为 受 这 个 属性 影响 的 方法 ”。 只 有 极 少 数 的 枚 举 受 益 于 将 多 

种 行为 与 单个 方法 关联 。 在 这 种 相对 少见 的 情况 下 ， 竺 定 于 名 量 的 方 

法 要 优 先 于 局 用 目 有 值 的 枚 举 。 如 有 果 多 个 枚 举 常 量 同 时 共享 相同 的 行 

为 ， 则 考虑 策略 枚 举 。 


第 31 条 : 用 实例 域 代 闪 序数 


许多 枚 举 天 生 就 与 一 个 单独 的 int 值 相 关联 。 所 有 的 枚 举 都 有 一 个 
ordinal 方法 ， 它 返 回 每 个 枚 举 常 量 在 类 型 中 的 数字 位 置 你 可 以 试 
着 从 序数 中 得 到 关联 的 in 值 : 


of ordinal to derive an associated value - DON'T DO THIS 


public enum Ensemble { 


SOLO, DUET, TRIO, QUARTET, QUINTET, 


SEXTET, SEPTET, OCTET, NONET, DECTET; 


public int numberOfMusicians{ return ordinal() + 1; } 


BPX PCE Aa, (EE ROR RS o UR ET PT 
HEF, numberOfMusicians FAA AAA ° 如 果 要 再 添加 一 个 与 已 经 
用 过 的 int 值 关 联 的 枚 举 常 量 ， 束 没 那 么 走运 了 。 例 如 ， 给 WA 
Æ (double quartet) 添加 一 个 常量 ， 它 就 像 个 八重 奏 一 样 ， 是 由 8 位 
演 到 家 组 成 ,但 是 没有 办 法 做 到 。 


要 是 没有 给 所 有 这 些 int 值 添加 常量 ， 也 无 法 给 某 个 int 值 添 加 常 
量 。 例 如 ， 假 设想 要 添加 一 个 常量 表示 WEZA (triple quartet) , 

它 由 12 位 演奏 家 组 成 。 对 于 由 11 位 演奏 家 组 成 的 合奏 曲 并 没有 标准 的 
术语 ， 因 此 只 好 给 没有 用 过 的 it 值 (11) 添加 一 个 虚拟 (dummy) 
常量 。 这 人 么 做 顶 多 就 是 不 太 好 看 。 如 果 有 许多 int 值 都 是 从 未 用 过 
的 ， 可 就 不 切实 际 了 。 


幸运 的 是 ， 有 一 种 很 简单 的 方法 可 以 解决 这 些 问题 。 允 记 不 要 视 启 枚 
EIF F TCR RAE, MER ERTE TELOF : 


public enum Ensemble { 


SOLO( 1 ), DUET( 2 ), TRIO( 3 ), QUARTET( 4 ), QUINTET( 5 ), 


SEXTET( 6 ), SEPTET( 7 ), OCTET( 8 ), DOUBLE_QUARTET( 8 ), 


NONET( 9 ), DECTET( 10 ), TRIPLE_QUARTET( 12 ); 


private final int numberOfMusicians; 


Ensemble( int size) { this .numberOfMusicians = size; } 


public int numberOfMusicians{ return numberOfMusicians; } 


Enum 规范 中 谈 到 ordinal 时 这 


文 么 写 到 ; 


“大 多 数 程序 员 都 不 需要 这 个 方法 。 它 是 设计 成 用 于 像 
eat aa 


i 
EnumMap IX A 


FIER 


Spi, 


Enumset All 


除非 你 在 编写 的 是 这 种 数据 结构 ， 否 则 最 好 完全 避免 使 用 ordinal 77 


法 。 


第 32 条 : 用 EnumSet 代替 位 域 


如 有 果 一 个 枚 举 类 型 的 元 素 主 要 用 在 集合 


一 般 束 是 用 


( 见 第 30 条 ) ， 将 2 的 不 同 倍数 赋予 每 个 常量 : 


// Bit field enumeration constants - 


public class Text 


public static 


public static 


public static 


public static 


{ 


final 


final 


final 


final 


// parameter is bitwise OR of 


public void 


OBSOLETE! 


STYLE_BOLD = 1 << 


ll 
B 


STYLE_ITALIC << 
STYLE_UNDERLINE -1 Bac 


STYLE_STRIKETHROUGH = 1 << 


zero or more STYLE_ constants 


applyStyles ( int styles) {et} 


int 


枚 举 模 式 


这 种 表示 法 让 你 用 or 位 运算 将 几 个 常量 合并 到 一 个 集合 中 ， 称 作 位 


tx (bit field) 


text.applyStyles(STYLE_BOLD | STYLE_ITALIC); 


位 域 表 示 法 也 允许 利用 位 操作 ， 有 效 地 执行 像 union (联合 ) 和 
intersection (2052) 这 样 的 集合 操作 。 但 位 域 有 着 in 枚 举 常量 的 所 
有 人 缺点， 甚至 更 多 。 当 位 域 以 数字 形式 打印 有 时， 翻译 位 域 比 翻译 简单 
的 int 枚 举 常 量 要 困难 得 多 。 其 至， 要 裔 历 位 域 表示 的 所 有 元 素 也 没 
有 很 容易 的 方法 。 


有 些 程序 员 优 先 使 用 枚 举 而 非 int 常量 ， 他 们 在 需要 传递 多 组 常量 集 
时 ， 仍 然 倾 同 于 使 用 位 域 。 其 实 没 有 理由 这 么 做 ， 因 为 还 有 更 好 的 奉 
代 方 法 。 java.util 包 提 供 了 enumsee 类 来 有 效 地 表示 从 单个 枚 举 类 型 
中 提取 的 多 个 值 的 多 个 集合 。 这 个 类 实现 see O, HERT FEAD 
能 、 类 型 安全 性 ， 以 及 可 以 从 任何 其 他 se 实现 中 得 到 的 互 用 性 。 但 
是 在 内 部 具体 的 实现 上 ， 每 个 Enunset 内 容 都 表示 为 位 矢量 。 如 果 底 
层 的 枚 举 类 型 有 64 个 或 者 更 少 的 元 素 一 一 大 多 如 此 一 一 整个 Enumset 
就 是 用 单个 ione 来 表示 ， 因 此 它 的 性 能 比 得 上 位 域 的 性 能 。 批 处 
m, 如 removeAll 和 retainAll , 都 是 利用 位 算法 来 实现 的 ， WAL 
王位 域 实 现 得 那样 。 但 是 可 以 避免 手 工 操作 时 容易 出 现 的 错误 以 及 不 
太 雅 观 的 代码 ， 因 为 Enunset 替 你 完成 了 这 项 艰巨 的 工作 。 


下 面 是 一 个 范例 改 成 用 枚 举 代 准 位 域 后 的 代码 ， 它 更 加 简短、 更 加 清 


楚 ， 也 更 加 安全 : 


// EnumSet - a modern replacement for bit fields 


public class Text { 


public enum Style { BOLD, ITALIC, UNDERLINE, STRIKETHROUGH } 


// Any Set could be passed in, but EnumSet is clearly best 


public void applyStyles (Set<Style> styles) A oan F 


下 面 是 将 EnumSet 实例 传递 给 applyStyles 方法 的 客户 端 代码 
pe! 提供 了 丰富 的 静态 工厂 来 轻松 创建 集合 ， 其 中 一 个 如 这 个 代 
码 所 示 : 


text.applyStyles(EnumSet.of(Style.BOLD, Style.ITALIC)); 


注意 applystyles 方法 采用 的 是 set<styles> 而 非 enumset<style> ° RIA 
看 起 来 好 像 所 有 的 客户 端 都 可 以 将 enunset 传递 到 这 个 方法 ， 但 是 最 
好 还 是 接受 接口 类 型 而 非 接受 实现 类 型 。 这 是 考虑 到 可 能 会 有 特殊 的 
客户 端 要 传递 一 些 其 他 的 see 实现 ， 并 且 没有 什么 明显 的 缺点 。 


总 而 言 之 ， 丰 趟 因为 科举 类 型 要 用 在 集 台 (Set) F, RAHAA 
PLEMRAR E ° Enunset 类 集 位 域 的 简洁 和 性 能 优势 及 第 30 条 中 所 
述 的 枚 举 类 型 的 所 有 优点 于 一 身 。 实 际 上 enunset AM, BU Bik 
Java 1.6 发 行 版 本 ， 它 都 无 法 创建 不 可 变 的 Enunset ， 但 是 这 一 点 很 可 
能 在 即将 出 来 的 版 本 中 得 到 修正 。 同 时 ， 可 以 用 
Collections.unmodifiableSet 将 EnumSet 封装 起 来 ， 但 是 简洁 性 和 性 能 会 
受到 影响 。 


第 33 条 : FA enma REFARI 


有 时 候 ， 你 可 能 会 见 到 利用 orani 方法 ( 见 第 31 条 ) 来 索引 数组 的 
代码 。 例 如 下 面 这 个 过 于 位 化 的 类 ， 用 来 表示 一 种 亮 饪 用 的 香草 : 


public class Hurb { 


public enum Type { ANNUAL, PERENNIAL, BIENNIAL } 


private final String name, 


private final Type type; 


Herb(String name, Type type) { 
this .name = name; 


this .type = type; 


@Override public String toString () { 


retuan name; 


假设 现在 有 一 个 香草 的 数组 ， 表 示 一 座 花 园 中 的 植物 ， 你 想 要 按照 类 
型 (一 年 生 、 多 年 生 或 者 两 年 生 植物 ) 进行 组 织 之 后 将 这 些 植物 列 出 
来 。 如 有 果 要 这 么 做 的 话 ， 需 要 构建 三 个 集合 ， 每 种 类 型 一 个 ， 并 且 允 
历 整 座 花园 ， 将 每 种 香草 放 到 相应 的 集合 中 。 有 些 程序 员 会 将 这 些 集 
合 放 到 一 个 按照 类 型 的 序数 进行 索引 的 数组 中 来 实现 这 一 点 。 


// Using ordinal() to index an array - DON'T DO THIS! 


Herb[] garden = ...; 


Set<Herb>[] herbsByType = // Indexed by Herb.type.ordinal() 
(Set<Herb>[]) new Set[Herb.Type.values().lenght]; 
for ( int i= 0 ; i < herbsByType.length; i++) 


herbsByType[i] = new HashSet<Herb>(); 


for (Herb h : garden) 


herbsByTyp[h.type.ordinal()].add(h); 


// Print the results 
for ( int i= © ; i < herbsByType.length; i++) { 
System.out.printf( "%s: %s%n" , 


Herb. Type.values()[i], herbsByType[i]) ; 


这 种 方法 的 确 可 行 ， 但 是 隐藏 着 许多 问题 。 因 为 数组 不 能 与 泛 型 ( 见 
第 25 条 ) 兼容 ， 程 序 需 要 进行 未 受 检 的 转换 ， 并 且 不 能 进行 正确 无 误 
的 编译 。 因 为 数组 不 知道 它 的 索引 代表 着 什么 ， 你 必须 手工 标注 
(label) 这 些 索 引 的 输出 。 但 是 这 种 方法 最 严重 的 问题 在 于 ， 当 你 访 
问 一 个 按照 枚 举 的 序数 进行 索引 的 数组 时 ， 使 用 正确 的 int TELL ET 
的 职责 了 ;int 不 能 提供 枚 举 的 类 型 安全 。 你 如 采 使 用 了 错误 的 值 ， 
程序 吏 会 悄悄 地 完成 噶 误 的 工作 ， 或 者 装运 的 话 ， 会 抛 出 


. cs 
ArrayIndexOutOfBoundException FF P 


幸运 的 是 ， 有 一 种 更 好 的 方法 可 以 达到 同样 的 效果 。 数 组 实际 上 充当 
着 从 枚 举 到 值 的 映 册 ， 因 此 可 能 还 要 用 到 map 。 更 具体 地 说 ， 有 一 种 
非常 快速 的 map 实现 专门 用 于 枚 举 键 ， 称 作 java'util,Enunap ° DAP 
就 是 用 java.util.EnumMap 改写 后 的 程序 : 


// Using an EnumMap to associate data with an enum 


Map<Herb.Type, Set<Herb>> herbsByType = 


new EnumMap<Herb.Type, Set<Herb>>(Herb.Type.class); 


for (Herb.Type t : Herb.Type.values()) 


herbsByType.put(t, new HashSet<Herb>()); 


for (Herb h : garden) 


herbsByType.get(h.type).add(h); 


System.out.printin(herbsByType) ; 


这 上 段 程序 更 简短 、 更 清楚 ， 也 更 加 安全 ， 运 行 速度 方面 可 以 与 使 用 序 
数 的 程序 相 妮 闫 。 它 没有 不 安全 的 转换 ， 不 必 手 工 标 注 这 些 索 引 的 输 
出 ， 因 为 映射 键 知道 如 何 将 目 号 翻译 成 可 打印 字符 哩 的 枚 举 ， 计 算数 
组 索引 时 也 不 可 能 出 错 。 enumap 在 运行 速度 方面 之 所 以 能 与 通过 序 


数 索引 的 数组 相 媲美 ， 是 因为 cnummap 在 内 部 使 用 了 这 种 数组 。 但 是 
它 对 程序 员 隐 藏 了 这 种 实现 细节 ， 集 map 的 丰富 功能 和 类 型 安全 与 数 
组 的 快速 与 一 身 。 注 意 enummap 构造 器 采 用 键 类 型 的 class 对 象 : 这 
是 一 个 有 限制 的 类 型 令 牌 (bounded type token) ， 它 提供 了 运行 时 的 
泛 型 信息 〈 见 第 29 条 ) 。 

你 还 可 能 见 到 按照 序数 进行 索引 (两 次 ， 的 数组 的 数组 ， 该 序数 表示 
两 个 枚 举 值 的 映射 。 例 如 ， 下 面 这 个 程序 束 古 使 用 这 样 一 个 数组 将 两 
个 阶段 映射 到 一 个 阶段 过 渡 中 〈 从 液体 到 固体 称 作 凝固 ， 从 液体 到 气 
体 称 作 沸 腾 ， 诸 如 此 类 ) o 


// Using ordinal() to index array of arrays - DON'T DO THIS! 
public enum Phase { SOLID, LIQUID, GAS; 
public enum Transition { 
MELT, FREEZE, BOIL, CONDENSE, SUBLIME, DEPOSIT; 
// Rows indexed by src-ordinal, cols by dst-ordinal 


private static final Transition[][] TRANSITIONS = { 


‘null F MELT, SUBLIME }, 

{ FREEZE, null , BOIL }, 

{ DEPOSIT, CONDENSE, null } 
3; 


// Returns the phase transition from one phase to another 


public static Transition from (Phase src, Phase dst) { 


return TRANSITIONS[src.ordinal()][dst.ordinal()]; 


IBC ATT, AEREE, (Ee SCIP SE UL © LAE EB 
A Fetal AS BE A aS BE, Sa Ee TCE AE RRRS | 
之 间 的 关系。 如 果 在 过 渡 表 中 出 了 错 ， 或 者 在 修改 phase 或 者 
Phase.Transition MCE SEAN AEN RR LE BE BT REP RS EIST A A 
败 ° 这 种 失败 的 形式 可 能 为 ArrayIndexOutOfBoundsException 7 
NullPointerexception 或 者 (更 糟糕 的 是 ) 没有 任何 提示 的 错误 行为 。 这 
张 表 的 大 小 是 阶段 个 数 的 平方 ， 即 使 非 nu 项 的 数量 比较 少 。 


同样 ， 利 用 enumwap 依然 可 以 做 得 更 好 一 些 。 因 为 每 个 阶段 过 渡 都 是 
al 对 阶段 枚 举 进 行 索引 的 ， 最 好 将 这 种 关系 表示 为 一 个 map , 1X 
map 的 键 是 一 个 枚 举 其实 阶段 ) ， 值 为 另 一 个 mp ， 这 第 二 个 

map 的 键 为 第 二 个 枚 举 〈 目 标 阶 段 } ， 它 的 值 为 结果 (阶段 过 渡 ) ， 
即 形成 了 va。 ERME, wo (ENEE MEDIE) ) 这 种 形 
式 。 一 个 阶段 过 渡 所 关联 的 两 个 阶段 ， 最 好 通过 “数据 与 阶段 过 渡 枚 举 
之 间 的 关联 ”来 获取 ， 之 后 用 该 阶段 过 渡 枚 举 来 初始 化 藤 套 的 Enunmap 


// Using a nested EnumMap to associate data with enum pairs 


public enum Phase { 


SOLID, LIQUID, GAS; 


public enum Transition { 


MELT(SOLID, LIQUID), FREEZE(LIQUID, SOLID), 


BOIL(LIQUID, GAS), | CONDENSE(GAS, LIQUID), 


SUBLIME(SOLID, GAS), DEPOSIT(GAS, SOLID); 


private final Phase src; 


private final Phase dst; 


Transition(Phase src, Phase dst) { 


this Bsre = Sre; 


this .dst 


dst; 


// Initialize the phase transition map 


private static final Map<Phase, Map<Phase, Transition>> m = 


new EnumMap<Phase, Map<Phase, Transition>>(Phase.class); 


static M 


for (Phase p : Phase.values()) 


m.put(p, new EnumMap<Phase, Transition>(Phase.class)); 


for (Transition trans : Transition.value() ) 


m.get(trans.src).put(trans.dst, trans); 


public static Transition from (Phase src, Phase dst) { 


return m.get(src).get(dst); 


初始 化 阶段 过 渡 map AMS BEER ET BER AAR, (eNOS 
ae ° map 的 类 型 为 Map<Phase, Map<Phase, Transition>> , 表示 是 由 键 为 源 
Phase ( 即 第 一 个 Phase ) ` 值 为 另 一 个 map 组 成 的 Map , 其 中 组 
成 值 的 Map 是 由 键 值 对 目标 Phase ( 即 第 二 个 Phase ) 、 Transition 
ZA BONY o ARAN MATS FA — ANTERA TANE map ， 得 到 
了 三 个 空 的 内 容 map 。 代 码 块 中 的 第 二 个 循环 利用 每 个 状态 过 小 音量 
提供 的 起 始 信息 和 目标 信息 初始 化 了 内 部 map 


现在 假设 想 要 给 系统 添加 一 个 新 的 阶段 ， plasma (AF) 或 者 电离 气 
体 。 只 有 两 个 过 渡 与 这 个 阶段 关联 : 电离 化 ， 它 将 气体 变 成 离子 ， 以 
及 消 电离 化 ， 将 离子 变 成 气体 。 为 了 更 新 基于 数组 的 程序 ， 必 须 给 

Phase 添加 一 种 新 常量 ， 给 Phase.Transition 添加 两 种 新 销量 ， 用 一 种 
新 的 16 个 元 素 的 版 本 取代 原来 9 个 元 素 的 数组 的 数组 。 如 果 给 数组 添 
加 的 元 素 过 多 或 者 过 少 ， 或 者 元 素 放 置 不 妥当 ， 可 融 麻 烦 了 : 程序 可 
以 编译 ， 但 是 会 在 运行 时 失败 。 为 了 更 新 基于 enma 的 版 本 ， 所 要 
做 的 就 是 必须 将 prasma 添加 到 phase 列表 ， 并 将 ronze ( cas ， 

PLASMA ) 和 DEIONIZE ( PLASMA , GAS ) 添加 到 Phase.Transition 的 列 
表 中 。 程 序 会 自行 处 理 所 有 其 他 的 事情 ， 你 几乎 没有 机 会 出 错 。 从 内 
部 来 看 ， map 的 map 被 实现 成 了 数组 的 数组 ， 因 此 在 提升 了 清楚 

ee 


AWEL, RERBZA/PEORA WSCA, MBSA enma 。 如 采 你 
所 表示 的 这 种 关系 是 多 维 的 ， WAE H EnumMap<..., EnumMap<...>> ° 应 用 
程序 的 程序 员 在 一 般 情况 下 都 不 使 用 Enum.ordinal , 即使 要 用 也 很 
少 ， 因 此 这 是 一 种 特殊 情况 ( 见 第 31 条 ) 。 


第 34 条 : 用 接口 模拟 可 伸缩 的 枚 举 


束 儿 乎 所 有 方面 来 看 ， 枚 举 类 型 都 优越 于 本 书 第 一 版 中 所 述 的 类 型 安 
全 枚 举 模 式 [Bloch01]。 从 表面 上 看 ， 有 一 个 异常 与 可 伸缩 性 有 关 ， 这 
个 异常 可 能 处 在 原来 的 模式 中 ， 却 没有 得 到 语言 构造 的 文 持 。 换 名 话 
说 ， 使 用 这 种 模式 ， 就 有 可 能 让 一 个 枚 举 类 型 去 扩展 另 一 个 枚 举 类 

型 ; 利用 这 种 语言 特性 ， 则 不 可 能 这 么 做 。 这 绝 非 偶然 。 枚 举 的 可 伸 
缩 性 最 后 证 明基 本 上 都 不 是 什么 好 点 子 。 扩 展 类 型 的 元 素 为 基本 类 型 
的 实例 ， 基 本 类 型 的 实例 却 不 是 扩展 类 型 的 元 素 ， 这 样 很 是 温 乱 。 目 
前 还 没有 很 好 的 方法 来 枚 举 基 本 类 型 的 所 有 元 素 及 其 扩展 。 最 终 ， 可 
伸缩 性 会 导致 设计 和 实现 的 许多 方面 变 得 复杂 起 来 。 


也 束 是 说 ， 对 于 可 伸缩 的 枚 举 类 型 而 言 ， 至 少 有 一 种 具有 说 服 力 的 用 
例 ， 这 就 是 EIZ (operation code) ， 也 称 作 opcode 。 操 作 吗 是 指 
这 样 的 枚 举 类 型 : 它 的 元 素 表 示 在 某 种 机 絮 上 的 那些 操作 ， 例 如 第 30 
条 中 的 operation 类 型 ， 它 表示 一 个 简单 的 计算 妖 中 的 某 些 函 数 。 有 
时 候 ， 要 尽 可 能 地 让 API 的 用 户 提 供 它 们 目 己 的 操作 ， 这 样 可 以 有 效 
地 扩展 API 所 提供 的 操作 和 集 。 


茎 运 的 是 ， 有 一 种 很 好 的 方法 可 以 利用 枚 举 类 型 来 实现 这 种 效果 。 由 
于 枚 举 类 型 可 以 通过 给 操作 码 类 型 和 (属于 接口 的 标准 实现 的 ) 枚 举 
定义 接口 ， 来 实现 任意 接口 ， 基 本 的 想法 就 是 利用 这 一 事实 。 例 如 ， 
以 下 是 第 30 条 中 的 operation 类 型 的 扩展 版 本 : 


// Emulated extensible enum using an interface 


public interface Operation { 


double apply ( double x, double y) ; 


public enum 


BasicOperation implements Operation { 


PLUS( "+" ) { 


public 


}, 


MINUS( "-" 


public 


}, 


TIMES( "*" 


public 


}, 


double apply ( double x, double 
) I 

double apply ( double x, double 
) ol 

double apply ( double x, double 


DIVIDE( "/" ) { 


public 


}; 


private 


double apply ( double x, double 


final String symbol; 


BasicOperation(String symbol) { 


this £ 


@Override 


symbol = symbol; 


public String toString () { 


y) 


y) 


y) 


y) 


return 


return 


return 


return 


x+y;} 


XV 
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x/ yi} 


return symbol; 


虽然 枚 举 类 型 ( pasicoperation ) 不 是 可 扩展 的 ， 但 接口 类 型 ( 
operation ) 则 是 可 扩展 的 ， 它 是 用 来 表示 API 中 的 操作 的 接口 类 型 。 
你 可 以 定义 另 一 个 枚 举 类 型 ， 它 实现 这 个 接口 ， 并 用 这 个 新 类 型 的 实 
例 代 替 基 本 类 型 。 例 如 ， 假 设 你 想 要 定义 一 个 上 述 操 作 类 型 的 扩展 ， 
Hak (exponentiation) 和 求 余 (remainder) 操作 组 成 。 你 所 要 做 的 
就 是 编写 一 个 枚 举 类 型 ， 让 它 实 现 Operation 接口 : 


// Emulated extension enum 


public enum ExtendedOperation implements Operation { 


EXP ( "AN ) { 


public double apply ( double x, double y) { 


return Math.pow(x, y); 


t, 


REMAINDER( "%" ) { 


public double apply ( double x, double y) { 


return Xx% y; 


private final String symbol; 
ExtendedOperation(String symbol) { 
this .symbol = symbol; 
} 
@Override public String toString () { 


return symbol; 
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被 写成 采用 接口 类 型 ( Operation ) 而 非 实 现 ( BasicOperation ) off 
意 ， 在 枚 举 中 ， 不 必 像 在 不 可 扩展 的 枚 举 中 所 做 的 那样 ， 利 用 特定 于 
实例 的 方法 实现 来 声明 抽象 的 apply 方法 。 这 是 因为 抽象 的 方法 ( 


apply ) 是 接口 ( operation ) 的 一 部 分 。 


不 仅 可 以 在 任何 需要 “基本 枚 举 ” 的 地 方 单独 传递 一 个 “ 打 展 枚 举 ” 的 实 
例 ， 而 且 除 了 那些 基本 类 型 的 元 素 之 外 ， 还 可 以 传递 完整 的 扩展 枚 举 
类 型 ， 并 使 用 它 的 元 素 。 例 如 ， 通 过 下 面 这 个 测试 程序 ， 体 验 一 下 上 
面 定 义 过 的 所 有 扩展 过 的 操作 : 


public static void main (String[] args) { 


double x = Double.parseDouble(args[ 9 ]); 


doubly y = Double.parseDouble(args[ 1 ]); 


test(ExtendedOperation.class, x, y); 


private static <T extends Enum<T> & Operation> void test ( 
Class<T> opSet, double x, double y) { 
for (Operation op : opSet.getEnumConstants()) 
System.out.printf( "%f %s %f = %f%n" , 


x, Op, y, Op.apply(x, y)); 


注意 扩展 过 的 操作 类 型 的 类 的 字面 文字 ExtendedOperation.class ) M 
main PIRES test 方法 ， 来 描述 被 扩展 操作 的 集合 。 这 个 的 字面 
文字 充当 有 限制 的 类 型 令 牌 ( 见 第 29 条 ) 。 opet 参数 中 公认 很 复杂 
的 声明 ( <T extends Enum<T> & Operation> ) 确保 了 Class 对 象 既 表示 榴 
举 又 表示 operation 的 子 类 型 ， 这 正 是 届 历 元 素 和 执行 与 每 个 元 素 相 
关联 的 操作 时 所 需要 的 。 


第 二 种 方法 是 使 用 Collection<? extends Operation> , 这 是 个 AR AAT 
三 符 类 型 (bounded wildcard type) (W285) ， 作 为 opset 参数 的 


public static void main (String[] args) { 


double x = Double.parseDouble(args[ 9 ]); 


doubly y = Double.parseDouble(args[ 1 ]); 


test(Arrays.asList(ExtendedOperation.values()), x, y); 


t 
private static void test (Collection<? extends Operation> opSet, 
double x, double y) { 
for (Operation op : opSet.getEnumConstants()) 
System.out.printf( "%f %s %f = %f%n" , 


xX, Op, y, Op.apply(x, y)); 


这 样 得 到 的 代码 没有 那么 复杂 ， test 方法 也 比较 灵活 一 些 : 它 人 允许 
调用 者 将 多 个 实现 类 型 的 操作 合并 到 一 起 。 另 一 方面 ， 也 放弃 了 在 指 
定 操作 上 使 用 Enunset ”( 见 第 32 条 ) 和 enummap 〈 见 第 33 条 ) 的 功 
能 ， 因 此 ， 除 非 需要 灵活 地 合并 多 个 实现 类 型 的 操作 ， 否 则 可 能 最 好 
使 用 有 限制 的 类 型 令 牌 。 


上 面 这 段 程序 用 命令 行 参 数 2 和 4 运行 时 ， 都 会 产生 这 样 的 输出 : 


4.000000 A 2.000000 = 16.000000 


4.000000 % 2.000000 = 0.000000 


用 接口 模拟 可 伸缩 枚 举 有 个 小 小 的 不 足 ， 既 无 法 将 实现 从 一 个 枚 举 类 
型 集成 到 另 一 个 枚 举 类 型 。 在 上 述 operation 的 示例 中 ， 保 存 和 获取 
与 某 项 操作 相关 联 的 符号 的 逻辑 代码 ， 可 以 复制 到 BasicOperation 和 
ExtendedOperation 中 。 在 这 个 例子 中 是 可 以 的 ， 因为 复制 的 代码 非常 
少 。 如 果 共 至 功能 比较 多 ， 则 可 以 将 它 封装 在 一 个 辅助 类 或 者 静态 辅 
助 方法 中 ， 来 避免 代码 的 复制 工作 。 


总 而 言 之 ， 及 然 无 涛 编写 避 办 展 的 攻 举 头 型 ， 却 可以 通过 编写 儿 万 以 
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自己 的 枚 举 来 实现 接口 。 如 果 API 是 根据 接口 编写 的 ， 那 么 在 可 以 使 
用 基础 枚 举 类 型 的 任何 地 方 ， 也 都 可 以 使 用 这 些 枚 举 。 


第 37 条 : 用 标记 接口 定义 类 型 


Pric#2O] (marker interface) 是 没有 包含 方法 声明 的 接口 ， 而 只 是 指 
明 (或 者 “标明 ”) 一 个 类 实现 了 具有 某 种 属性 的 接口 。 例 如 ， 考 虑 
serializable 接口 ( 见 第 11 章 ) 。 通 过 实现 这 个 接口 ， 类 表明 它 的 实例 
可 以 被 写 到 ObjectOutputStream (或 者 “被 序列 化 ”) 2 


你 可 能 听 说 过 标记 注解 〈 见 第 35 条 ) 使 得 标记 接口 过 时 了 。 这 种 断言 
征 不 正确 的 。 标 记 接口 有 两 点 胜 过 标记 注解 。 首 先 ， 也 是 最 重要 的 一 
Be, PICI Le XR EA BIDICRI LAL; PCE REM 
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的 情况 下 要 到 运行 时 才能 捕捉 到 的 错误 。 


iL Serializable 标记 接口 而 A, 如 果 它 的 参数 没有 实现 该 接口 ， 
ObjectOutputStream.write(Object) 方法 将 会 失败 a 令 人 不 解 的 是 ， 
ObjectOutputStream API 的 创建 者 在 声明 write 方法 时 并 没有 利用 
Serializable 接口 。 该 方法 的 参数 类 型 应 该 为 Serializable 而 非 Object 
。 因 此 ， 试 着 在 没有 实现 serializable 的 对 象 上 调用 
ObjectoutputStream.write , 只 会 在 运行 时 失败 ， 但 也 并 不 一 定 如 此 。 


标记 接口 胜 过 标记 注解 的 另 一 个 有 点 事 ， 它 们 可 以 更 加 精确 地 进行 锁 
定 。 如 果 注 解 类 型 利用 @rarget(ElementType.TYPE) 声明 ， 它 束 可 以 被 应 用 
到 人 在 订 类 或 者 接口 。 假 设 有 一 个 标记 只 适用 于 特殊 接口 的 实现 。 如 果 
fee ee 就 可 以 用 它 将 唯一 的 接口 扩展 成 它 适 用 的 
z ° 


set 接口 可 以 说 就 是 这 种 AR Ain ICE (restricted marker 
interface) 9 它 只 适用 于 Collection TRH, 但 是 它 ` 会 添加 除了 
Collection 方法 的 契约 ， 包括 add equals 和 hashCode 9 但 是 很 容 
易 想象 只 适用 于 某 种 特殊 接口 的 子 类 型 的 标记 接口 ， 它 KA 改进 接口 
的 任何 方法 的 契约 。 这 种 标记 接口 可 以 描述 整个 对 象 的 某 个 约束 条 
件 ， 或 者 表明 实例 能 够 利用 其 他 某 个 类 的 方法 进行 处 理 (就 想 
人 接口 表明 实例 Ay 以 通过 ObjectOutputStream 进行 处 理 一 


标记 注解 胜 过 标记 接口 的 最 大 优点 在 于 ， 它 可 以 通过 默认 的 方式 添加 
一 个 或 者 多 个 注解 类 型 元 素 ， 给 一 被 使 用 的 注解 类 型 添加 更 多 的 信息 
[JLS，9.6]。 随 着 时 间 的 推移 ， 人 简单 的 标记 注解 类 型 可 以 演变 成 更 加 让 
富 的 注解 类 型 。 这 种 演变 对 于 标记 接口 而 言 则 是 不 可 能 的 ， 因 为 它 通 
常 不 可 能 在 实现 接口 之 后 再 给 它 添加 方法 〈 见 第 18 条 ) 。 


标记 注解 的 男 一 个 优点 在 于 ， 它 们 是 更 大 的 注解 机 制 的 一 部 分 。 
eae ea lee 


那么 什么 时 候 应 该 使 用 标记 注解 ， 什 么 时 候 应 该 使 用 标记 接口 呢 ? 很 
显然 ， 如 果 标 记 是 应 用 到 任何 程序 元 素 而 不 是 类 或 者 接口 ， 丈 必须 使 
用 注解 ， 因 为 只 有 类 和 接口 可 以 用 来 实现 或 者 扩展 接口 。 如 果 标 记 只 
应 用 给 类 和 接口 ， 就 要 问 问 目 己 ， 我 要 编写 一 个 还 是 多 个 只 接受 有 这 
种 标记 的 方法 呢 ? 如 果 是 这 种 情况 ， 束 应 该 优先 使 用 标记 接口 而 非 注 
解 。 这 样 你 束 可 以 用 接口 作为 相关 方法 的 参数 类 型 ， 它 真正 可 以 为 你 
提供 编译 时 进行 类 型 检查 的 好 处 。 


如 有 果 你 对 第 一 个 问题 的 管 案 是 否定 的 ， 束 要 再 问 问 目 己 :我 要 永远 限 
制 这 个 标记 只 用 于 特殊 接口 的 元 素 吗 ? 如 采 是 ， 最 好 将 标记 定义 成 该 
接口 的 一 个 子 接口 。 如 采 这 两 个 问题 的 答案 部 是 否定 的 ， 或 许 束 应 该 
使 用 标记 注解 。 


总 而 言 之 ， 标 记 接 口 和 标记 注解 都 各 有 用 处 。 如 果 要 定义 一 个 任何 新 
方法 都 不 会 与 之 关联 的 类 型 ， 标 记 接 口 束 是 最 好 的 选择 。 如 有 果 想 要 标 
记 程 序 元 素 而 非 类 和 接口 ， 考 虑 到 未 来 可 能 要 给 标记 添加 更 多 的 信 
已 ， 或 者 标记 要 适合 于 已 经 广泛 使 用 了 注解 类 型 的 框架 ， 那 么 标记 注 
解 就 是 正确 的 选择 。 WRIRARUA CHER SW Abt 
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从 某 种 意义 上 说 ， 本 条 目 与 第 19 条 中 “如 采 不 想 定 义 类 型 殉 不 要 使 用 接 
人 
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